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软件 质量 ， 不 但 依赖 于 架构 及 项 目 管理 ， 而 且 与 代码 质量 紧密 相关 。 这 一 点 ， 无 论 是 敏 
捷 开 发 流派 还 是 传统 开发 流派 ， 都 不 得 不 承认 。 | 

本 书 提 出 一 种 观念 ,代码 质量 与 其 整洁 度 成 正比 。 干 净 的 代码 ， 既 在 质量 上 较为 可 靠 ， 
也 为 后 期 维护 、 升 级 莫 定 了 恨 好 基础 。 作 为 编程 领域 的 佼佼 者 ， 本 书 作者 给 出 了 一 系列 行 之 
有 效 的 整洁 代码 操作 实践 。 这 些 实践 在 本 书 中 体现 为 一 条 条 规则 (或 称 “ 启 示 ”)， 并 辅 以 来 
自 现实 项 目的 正 、 反 两 面 的 范例 。 只 要 遵循 这 些 规则 ， 就 能 编写 出 干净 的 代码 ， 从 而 有 效 提 
升 代码 质量 。 

本 书 阅 读 对 象 为 一 切 有 志 于 改善 代码 质量 的 程序 员 及 技术 经 理 。 书 中 介绍 的 规则 均 来 自 
作者 多 年 的 实践 经 验 ， 涵 盖 从 命名 到 重 构 的 多 个 编程 方面 ， 虽 为 一 “家 ”之 言 ， 然 诚 有 可 资 
Seng, 





ARM 〈Ga-Jol) 是 在 丹麦 最 受 欢迎 的 糖果 品种 之 一 ， 它 浓郁 的 甘草 味道 ， 完 美 地 弥补 了 
此 地 潮湿 且 时 常 寒冷 的 天 气 。 对 于 我 们 这 些 丹麦 人 ， 乐 鄙 的 妙 处 还 在 于 包装 盒 顶 上 印 制 的 哲 
言 慧 语 。 今 早 我 买 了 一 包 两 件 装 ， 在 其 包装 盒 上 发 现 这 句 丹 麦 谚语 : 

Ærlighed i små ting er ikke nogen lille ting. — 

“小 处 诚实 非 小 事 。” 这 人 句 话 正好 是 我 想 在 这 里 说 的 。 以 小 见 大 。 本 书写 到 了 一 些 价值 下 
胜 的 小 主题 。 

神 在 细节 之 中 ， 建 筑 师 Ludwig mies van der Rohe 〈 路 德 维 希 。 密 斯 。 范 。 德 。 5 ) 如 是 
说 。 这 人 句 话 引发 了 有 关 软 件 开发 、 特 别 是 敏捷 软件 开发 中 架构 所 处 地 位 的 若干 争论 。 鲍 勃 
(Bob) “和 我 时 常 发 现 自己 沉 洒 于 此 类 对 话 中 。 没 错 ，Ludwig mies van der Rohe 的 确 专注 于 
效用 和 基于 宏伟 架构 之 上 的 永恒 建筑 形式 。 然 而 ， 他 也 为 自己 设计 的 每 所 房屋 挑选 每 个 门 把 
手 。 为 什么 ? 因为 小 处 见 大 。 

就 TDD? 话 题 展开 目前 仍 在 继续 的 “辩论 ”时 ， 鲍 勃 和 我 认识 到 ， 我 们 均 同 意 软件 架构 
在 开发 中 占据 重要 地 位 ， 但 就 其 确切 意义 而 言 ， 我 们 之 间 还 有 分 上 层 。 然 而 ， 这 种 矛 与 盾 训 利 
的 讨论 相对 而 言 并 不 重要 ， 因 为 在 项 目 开始 之 时 ， 我 们 理所当然 应 该 让 专业 人 士 投入 些许 时 
间 去 思考 及 规划 。20 世纪 90 年 代 末 期 有 关 仅 以 测试 和 代码 驱动 设计 的 概念 已 一 去 不 返 。 相 
对 于 任何 宏伟 愿景 ， 对 细节 的 关注 甚至 是 更 为 关键 的 专业 性 基础 。 首 先 ， 开 发 者 通过 小 型 实 
践 获得 可 用 于 大 型 实践 的 技能 和 人 信用度。 其次, 宏大 建筑 中 最 细小 的 部 分 ， 比 如 关 不 紧 的 门 、 
有 点 儿 没 铺 平 的 地 板 ， 其 至 是 凌乱 的 桌面， 都 会 将 整个 大 局 的 魅力 毁灭 懈 尽 。 这 就 是 整洁 代 
码 之 所 系 。 

架构 只 是 软件 开发 用 到 的 借 喻 之 一 ， 主 要 用 在 那 种 等 同 于 建筑 师 区 付 毛 坯 房 一 般 交 付 初 
始 软件 产品 的 场合 。 在 Scrum 和 敏捷 (Agile) 的 日 子 里 ， 人 们 关注 的 是 快速 将 产品 推 问 市 场 。 
我 们 要 求 工厂 全 速 运转 、 生 产 软 件 。 这 就 是 人 类 工厂 : 懂 思 考 、 会 感受 的 编码 人 ， 他 们 由 产 
品 备 态 或 用 户 故事 开始 创造 产品 。 来 自制 造 业 的 借 喻 在 这 种 场合 大 行 其 道 。 例 如 ，Scrum 就 
从 装配 线 式 的 日 本 汽车 生产 方式 中 获 益 良 多 。 





而 言 ， 百 分 之 八 十 或 更 多 的 工作 量 集中 在 我 们 美 其 名 日 “维护 ”的 事情 上 : 其 实 就 是 修 修补 


译注 ，20 世纪 中 期 著名 现代 建筑 大 师 ， 生 承 “ 少 即 是 多 ”的 建筑 设计 哲学 ， 缔造 了 玻璃 幕墙 等 现代 建筑 结构 。 
? 译注， 本 书 主 要 作者 Robert C. Martin 绰号 Uncle Bob， 这 里 的 “ 鲍 勃 ”及 后 文 的 “ 鲍 勃 大 权 ” 就 是 指 Robert C. Martin. 
3 译注 :; Test Driven Development， 测 试 驱 动 开发 。 
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补 。 与 其 接受 西方 关于 制造 好 软件 的 传统 看 法 ， 不 如 将 其 看 作 建 筑 工 业 中 的 房屋 修理 工 ， 或 
者 汽车 领域 的 汽 修 工 。 日 本 式 管理 对 于 这 种 事 怎么 说 的 呢 ? 

大 约 在 1951 年 ， 一 种 名 为 “全 员 生 产 维护 ”(Total Productive Maintenance, TPM) 的 质量 
保证 手段 在 日 本 出 现 。 它 关 注 维护 其 于 关注 生产 。 TPM 的 主要 支柱 之 一 是 所 谓 的 5S 原则 体系 。 
5S 是 一 套 规程 , 用 “规程 ”这 个 词 ， 是 为 了 读者 便于 理解 。5S 原则 其 实 是 精益 (Lean) 一 一 西 
方 视 野 中 的 Gol 
(Uncle Bob) 在 前 言 中 写 到 的 ， 良 好 的 软件 实践 遵循 这 些 规程 ， 专 注 、 镇 定 和 思考 。 这 并 非 
总 只 有 关 实 作 ， 有 关 推 动工 厂 设 备 以 最 高 速度 运转 。 5S 哲学 包括 以 下 概念 : 

e 整理 (Seiri) ` ， 或 谓 组 织 〈 想 想 英语 中 的 sort (9%, HF) 一 词 )。 搞 清 楚 事物 之 

所 在 一 一 通过 恰当 地 命名 之 类 的 手段 一 一 至 关 重 要 。 TE HEURES ik 
” ”后 面 的 章节 吧 。 
e 整顿 (Seiton), 或 谓 整 齐 ( 想 想 英文 中 的 systematize (系统 化 ) 一 词 )。 有 名 美国 老 
话说 : 物 骨 有 其 位 ， 而 后 物 尽 归 其 位 (A place for everything, and everything in its 
| place). SIAS d Dr 就 需要 重 构 了 。 
e 清楚 (Seiso)， 或 谓 清洁 〈( 想 想 英 文中 的 shine (4255) 一 词 )。 清 理工 作 地 的 拉线 、 
油污 和 边 角 废料 。 对 于 那 种 四 处 遗弃 的 带 注释 的 代码 及 反映 过 往 或 期 望 的 无 注释 代 
” 码 ， 本 书 作者 怎么 说 的 来 着? 除 之 而 后 快 。 
e 清洁 (Seiketsu)， 或 谓 标准 化 。 有 关 如 何 保持 工作 地 清洁 的 组 内 共识 。 本 书 有 没有 
撼 到 在 开发 组 内 使 用 一 贯 的 代码 风格 和 实践 手段 ? 这 些 标准 从 哪里 来 ? 读 读 看 。 
e BÆ (Shitsuke) ， 或 谓 纪 律 〈 上 自律 )。 在 实践 中 贯彻 规程 ， 并 时 时 体现 于 个 人 工作 
上 ， 而 且 要 乐于 改进 。 
如 果 你 接受 挑战 一 一 没 错 ， 就 是 挑战 ， 阅 读 并 应 用 本 书 ， 你 就 会 理解 和 赞 黄 上 述 最 后 一 
条 。 我们 最 终 是 在 驶 同一 种 负责 任 的 专业 精神 之 根源 所 在 ， 这 种 专业 性 隶属 于 一 个 关注 产品 
生命 周期 的 专业 领域 。 在 我 们 遵循 TPM 来 维护 机 动车 和 其 他 机 械 时 ， 停 机 维护 一 一 等 待 缺 
_ 陷 显现 出 来 一 一 并 不 常见 。 我 们 更 上 一 层 楼 :每 天 检查 机 械 ， 在 磨损 机 件 停止 工作 之 前 就 换 
. 牛 它 ,或 者 按 常 例 每 1000 英里 〈 约 1609.3km) 就 更 换 润滑 油 、 防 止 磨损 和 开裂 。 对 于 代码 ， 
”应 无 情 地 做 重 构 。 还 可 以 更 进一步 ， 就 像 TPM 运动 在 50 多 年 前 的 创新 : 一 开始 就 打造 更 易 
维护 的 机 械 。 写 出 可 读 的 代码 ， 重 要 程度 不 亚 于 写 出 可 执行 的 代码 。1960 FEH, 围绕 TPM 
村 | 入 的 终极 实践 《ultimate practice)， 关 注 用 全 新 机 械 替 代 旧 机 械 。 诚 如 Fred Brooks 所 言 ， 
我 们 或 许 应 该 每 7 年 就 重 做 一 次 软件 的 主要 模块 ， 清 理 缓慢 陈腐 的 代码 。 也 许 我 们 该 把 重 构 
”周期 从 以 年 计 缩 短 到 以 周 、 以 天 甚至 以 小 时 计 。 那 便 是 细节 所 在 了 。 | 
pie Dez, 而 在 生活 中 应 用 此 类 手段 时 也 有 微 言 大 义 ， 就 像 我 们 一 成 不 变 地 对 那 

















|, 这些 概念 最 初出 现 于 日 本 ，5 个 概念 的 日 文 罗 马 字 拼音 首 字母 正 好 都 是 S， 所 以 这 里 也 保留 了 日 文 罗马 字 拼音 
法。 中 译本 以 日 文 汉字 直接 译 出 ， 读 者 留意 ， 不 可 直接 对 应 其 中 文章 因 。 
“译注 ， 中 文章 为 “素养 、 教 养 ”。 
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些 源 自 日 本 的 做 法 寄予 厚望 一 般 。 这 并 非 只 是 东方 的 生活 观 ， 英 美 民 间 也 遍 是 这 类 警句 。 上 
g| “#20” (Seiton) 二 字 了 吏 曾 出 现在 某 位 俄亥俄 州 牧 师 的 笔下 ， 他 把 齐整 看 作 是 “ 荡 涤 种 种 
罪恶 之 民 方 ”。“ 清 楚 ”(Seiso) 又 如 何 呢 ? AFE (Cleanliness is next to godliness) 。 
一 张 脏 乱 的 朱子 足以 夺 去 一 所 丽 宅 的 光彩 。 老 话 怎么 说 “ 身 美 ”(Shitsuke) 的 ? 守 小 节 者 不 
亏 大 节 (He who is faithful in little is faithful in much)。 对 于 时 时 准备 在 恰当 时 机 做 重 构 ， 为 未 
来 的 “大 ”决定 夯实 基础 , 而 不 是 置 诸 脑 后 ， 有 什么 说 法 吗 ? 及 时 一 针 省 九 针 CA stitch in time 
saves nine). 早起 的 鸟 儿 有 虫 吃 (The early bird catches the worm). 日 事 日 毕 (Don*t put off until 
tomorrow what you can do today)。 在 精益 实践 落 入 软件 咨询 师 之 手 前 ， 这 就 是 其 所 谓 “ 最 后 
时 机 ”的 本 义 所 在 。 摆 正 单项 工作 在 整体 中 的 位 置 呢 ? 巨 木 生 于 树 籽 (Mighty oaks from little 
acorns grow)。 如 何在 日 常生 活 中 做 好 简单 的 防备 性 工作 呢 ? 防 病 好 过 治 病 (An ounce of 
prevention is worth a pound of cure), 一 天 一 苹果 ， 医 生 远离 我 (An apple a day keeps the doctor 
away)。 整 洁 代 码 以 其 对 细节 的 关注 ， 荣 耀 了 深 埋 于 我 们 现 有 、 或 兽 有 、 或 该 有 的 壮丽 文化 
之 下 的 智慧 根源 。 

即便 是 在 宏伟 的 建筑 作品 中 ,我 们 也 昕 到 关注 细节 的 回响 。 想 想 Ludwig mies van der Rohe 
的 门 把 手 吧 。 那 正 是 整理 (seiri) 。 认 真 对 待 每 个 变量 名 。 你 当 用 为 自己 第 一 个 孩子 命名 般 
的 谨慎 来 给 变量 命名 。 — 

正如 每 位 房 主 所 知 ， 此 类 照料 和 修 莹 永 无 休止 。 建筑 师 Christopher Alexander 一 一 模式 与 
模式 语言 之 父 一 一 把 每 个 设计 动作 看 作 是 较 小 的 局 部 修复 动作 。 他 认为 ， 设 计 良 好 结构 才 是 
而 更 大 的 建筑 形态 则 当 留 给 模式 及 居住 者 搬 进 的 家 私 来 完成 。 设 计 始 终 
”在 持续 进行 ， 不 只 是 在 新 建 一 个 房间 时 ， 也 在 我 们 重新 粉刷 墙 面 、 更 换 旧 地 毯 或 者 换 厨 房 水 
TI. RE 在 寻找 其 他 推崇 细节 的 人 时 ， 我们 发 现 ，19 世纪 法 国 
作家 Gustav Flaubert 〈 古 斯 塔 夫 。 福 楼 拜 ) 名 列 其 中 。 法 国 诗人 Paul Valery (RR ° MEE) 
认为 ， 每 首 诗歌 都 无 写 完 之 时 ， 得 持续 重 写 ， 直 至 放弃 为 止 。 全 心 倾注 于 细节 ， 屡 见于 追求 
卓越 的 行为 之 中 。 虽 然 这 无 其 新 意 ， 但 阅读 本 书 对 读者 仍 是 一 种 挑战 ， 你 要 重 拾 久 已 弃置 脑 
后 的 良好 规则 ， 自 发 自主 ,“ 响 应 改变 ”。 

不 幸 的 是 ， 我 们 往往 见 不 到 人 们 把 对 细节 的 关注 当 作 编程 艺术 的 基础 要 件 ， 我 们 过 早 地 
放弃 了 在 代码 上 的 工作 ， 并 不 是 因为 它 业 已 完成 ， 而 是 因为 我 们 的 价值 体系 关注 外 在 表现 其 
于 关注 要 交付 之 物 的 本 质 。 朴 忽 最 终结 出 了 恶果 :， 坏 东 西 一 再 出 现 。 无 论 是 在 行业 里 还 是 学 
术 领 域 ， 研 究 者 都 很 重视 代码 的 整洁 问题 。 供 职 于 贝尔 软件 生产 研究 实验 室 〈Bell Labs 
Software Production Research) 一 一 没 错 ， 就 是 生产 ! 时 ， 我 们 有 些 不 太 严 密 的 发 现 ， 认 
为 前 后 一 致 的 缩 进 风 格 明显 标志 了 较 低 的 缺陷 率 。 我 们 原 指望 将 质量 归 因 于 架构 、 编 程 语 言 
或 者 其 他 高 级 概念 ， 我 们 的 专业 能 力 归功 于 对 工具 的 掌握 和 各 种 高 高 在 上 的 设计 方法 ， 至 于 
那些 安置 于 厂区 的 机 器 ， 那 些 编码 者 ， 他 们 居然 通过 简单 地 保持 一 致 缩 进 风 格 创造 了 价值 ， 
这 简直 是 一 种 侮辱 ,我 在 17 年 前 就 在 书 中 写 过 , 这 种 风格 远 不 止 是 一 种 单纯 的 能 力 那么 简单 。 
日 本 式 的 世界 观 深 知 日 常 工作 者 的 价值 ， 而 且 ， 还 深 知 工 作者 简单 的 日 常 行 为 所 锻造 的 开发 





Fr IV 


系统 的 价值 。 质 量 是 上 百 万 次 全 心 投入 的 结果 一 一 而 非 仅 归功 于 任何 来 自 天 堂 的 伟大 方法 。 
这 些 行为 简单 却 不 简陋 ， 也 不 意味 着 简易 。 相 反 ， 它 们 是 人 力 所 能 达 的 不 仅 伟大 而 且 美 丽 的 
造物 。 忽 略 它 们 ， 就 不 成 其 为 完整 的 人 。 | ! | 

当然 ， 我 仍然 提倡 放宽 思路 ， 也 推崇 根植 于 深厚 领域 知识 和 软件 可 用 性 的 各 种 架构 手法 
的 价值 。 但 本 书 与 此 无 关 一 一 至 少 ， 没 有 明显 关系 。 本 书 精妙 之 处 ， 其 意义 之 深远 ， 不 该 无 
人 赏识 。 它 正 与 Peter Sommerlad、Kevlin Henny 及 Giovanni Asproni 等 真正 写 代码 的 人 现今 
所 持 的 观念 相 吻 合 。 他 们 鼓吹 “代码 即 设计 ”和 “简单 代码 ”我 们 要 谨 记 ， 界 面 就 是 程序 ， 
而 且 其 结构 也 极 大 地 反映 出 程序 结构 ， 但 也 理应 始终 谦逊 地 承认 设计 存在 于 代码 中 ， 这 有 至 关 
紧要 。 制造 上 的 返工 导致 成 本 上 升 , 但 重 做 设计 却 创造 出 价值 。 我 们 应 当 视 代码 为 设计 一 一 作 
为 过 程 而 非 终 点 的 设计 一 一 这 种 高 尚 行为 的 漂亮 体现 耦合 与 内 聚 的 架构 韵律 在 代码 中 脉动 。 
Larry Constantine 以 代码 的 形式 一 一 而 不 是 用 UML 那 种 高 高 在 上 的 抽象 概念 一 一 来 描述 耦合 
Es. Richard Garbriel Æ “Abstraction Descant” (WAW) 一 文中 告诉 我 们 ， 抽 象 即 恶 。 
代码 除 恶 ， 而 整洁 的 代码 则 大 抵 是 圣洁 的 。 

回 到 我 那个 小 小 的 乐 嚼 包装 盒 ， 我 想 要 重点 提 一 下 ， 那 名 丹麦 谚语 不 只 是 教 我 们 重视 小 
处 ， 更 教 我 们 小 处 要 诚实 。 这 意味 着 对 代码 诚实 、 对 同僚 坦承 代码 现状 ， 最 重要 的 是 在 代码 
问题 上 不 自 坎 。 是 否 已 尽 全 力 “ 把 露营 地 清理 得 比 来 时 还 干净 ”? 签 入 代码 前 是 否 已 做 重 构 ? 
这 可 不 是 皮毛 小 事 ， 它 正高 卧 于 敏捷 价值 的 正中 位 置 。Scrum 有 一 种 建议 的 实践 ， 主 张 重 构 
是 “完成 ”Done) 概念 的 一 部 分 。 无 论 是 架构 还 是 代码 都 不 强求 完美 ， 只 求 竭诚 尽力 而 已 。 
人 就 无 过 ， 神 亦 容 之 《To err is human; to forgive, divine). Æ Scrum 中 ， 我 们 使 一 切 可 见 。 我 
ATOR HAAR ERS 我 们 坦承 代码 状态 ， 因 为 它 永 不 完美 。 我 们 日 渐 成 为 完整 的 人 ， 配 得 起 神 的 
眷顾 ， 也 越 来 越 接近 细节 中 的 伟大 之 处 。 | 

在 上 自己 的 专业 领域 中 ， 我 们 肿 需 能 得 到 的 一 切 帮助 。 假 使 干净 的 地 板 能 减少 事故 发 生 ， 
假使 归 置 到 位 的 工具 能 提升 生产 力 ， 我 也 会 倾 力 做 到 。 至 于 本 书 ， 在 我 看 过 的 有 关 将 精益 原 
则 应 用 于 软件 的 印刷 品 中 ， 是 最 具 实用 性 的 。 那 班 求索 者 多 年 来 并 肩 奋 斗 ， 不 但 是 为 求 一 已 
之 进步 ， 更 将 他 们 的 知识 通过 和 你 手 上 正在 做 的 事 一 般 的 工作 贡献 给 这 个 行业 。 看 过 鲍 勃 大 
叔 寄 来 的 原稿 之 后 ， 我 发 现 ， 世 界 竟 略 有 改善 了 。 | 

对 高 瞻 远 瞩 的 练习 业已 结束 ， 我 要 去 清理 自己 的 书桌 了 。 








James O. Coplien 于 丹麦 默 尔 鲁 普 








2007 年 3 H, RE SD West 2007 技术 大 会 上 聆听 了 Robert C. Martin (MAKO 的 主 

题 演讲 “Craftsmanship and the Problem of Productivity: Secrets for Going Fast without Making a 
Mess”。 一 身 休 闲 打扮 的 鲍 勃 大 权 ， 以 一 曲 嘲笑 低 水 平 编码 者 的 Code — oL 
开场 。 | 

是 的 ， 我 们 就 是 一 群 代码 猴子 ， 上 蹄 下 跳 ， 自 以 为 全 DEE E 当 我 们 抓 
着 几 个 酸 桃子 ， 得 意 洋洋 坐 到 树枝 上 ， 却 对 自己 造成 的 混乱 熟视无睹 。 那 堆 “ 可 以 运行 ”的 
乱 抹 程序 ， 就 在 我 们 的 眼皮 底下 慢 慢 腐 坏 。 

从 听 到 那 场 以 TDD 为 主题 的 演讲 之 后 ， 我 就 一 直 关 注 鲍 勃 大 尿 ， 还 有 他 在 TDD 和 整洁 
代码 方面 的 言论 。 去 年 , 人 民 邮 电 出 版 社 计算 机 分 社 拿 一 本 书 给 我 看 , 封面 上 赫然 号 者 Robert 
C. Martin 的 大 名 。 看 完 原 书 序 和 前 言 ， 我 已 经 按 撩 不 住 ， 接 下 了 翻译 此 书 的 任务 。 这 本 书 名 
为 Clean Code, JE Object Mentor〈 鲍 勃 大 叔 开办 的 技术 咨询 和 堵 训 公司 ) 一 干 大 牛 在 编程 
方面 的 经 验 累 积 。 按 鲍 勃 大 板 的 话 来 说 ， 就 是 “Object Mentor 整洁 代码 派 ” 的 说 明 。 

正如 Coplien 在 序 中 所 言 ， 宏 大 建筑 中 最 细小 的 部 分 ， 比 如 关 不 紧 的 门 、 有 点 儿 没 铺 平 
的 地 板 ， 甚 至 是 凌乱 的 桌面 ， 都 会 将 整个 大 局 的 魅力 毁灭 列 尽 。 这 就 是 整洁 代码 之 所 系 。 
Coplien 列举 了 许多 谚语 , 证明 整 洁 的 价值 ， Gen UE 整洁 代码 的 
重要 性 毋庸 置疑 ， 问 题 是 如 何 写 出 真正 整洁 的 代码 。 

本 书 既 是 整洁 代码 的 定义 ， ae tae ea HKU, “BM, 
需要 遵循 大 量 的 小 技巧 ， 贯 彻 刻苦 习 得 的 “整洁 感 '。 这 种 “代码 感 ” 就 是 关键 所 在 …… 它 不 
仅 让 我 们 看 到 代码 的 优 和 劣 ， op ee dee ”作者 阐述 了 在 命名 、 函 
数 、 注 释 、 代 码 格式 、 对 象 和 数据 结构 、 错 误 处 理 、 边 界 问题 、 单 元 测试 、 类 、 系 统 、 并 发 
编程 等 方面 如 何 做 到 整洁 的 经 验 与 最 佳 实践 。 长 期 遵照 这 些 经 验 编写 代码 ， 所 谓 “ 代 码 感 ” 
也 就 自然 而 然 激 生出 来 。 更 有 价值 的 部 分 是 鲍 勃 大 上 板 本 人 对 3 个 Java 项 目的 训 析 与 改进 过 程 
的 实 操 记 录 。 通 过 这 多 达 3 章 的 重 构 记 录 ， 鲍 勃 大 叔 充 分 地 证 明了 童子 军 军 规 在 编程 领域 同 
样 适 用 : 离开 时 要 比 发 现时 更 整洁 。 为 了 向 读者 呈现 代码 的 原始 状态 ， 这 部 分 代码 及 本 书 其 
他 部 分 的 绝 大 多 数 代 码 注 释 都 不 做 翻译 。 如 果 读 者 有 任何 疑问 ， 可 通过 邮件 与 我 沟通 
(cleancode.cn@gmail.com). | 

接触 开发 技术 十 多 年 以 来 , 特别 是 从 事 IT 技术 媒体 工作 六 年 以 来 , 我 见 过 许多 对 于 代码 
整洁 性 缺乏 足够 重视 的 开发 者 。 不 算 过 分 地 说 ， 这 是 职业 素养 与 基本 功 的 双重 缺陷 。 我 翻译 
The Elements of CH Style (中 译 版 《C# 编 程 风格 》) 和 本 书 ， 实 在 也 是 希望 在 这 方面 看 到 开发 


代码 猴子 与 童子 军 军 规 Il 


者 重视 度 和 实际 应 用 的 提升 。 | 

在 本 书 的 结束 语 中 , 鲍 勃 大 叔 提 到 别人 给 他 的 一 条 腕 带 ， 上 面 的 字样 是 Test Obsessed (ii 
KANA). MAKE “发 现 自己 无 法 取 下 腕 带 。 不 仅 是 因为 腕 带 很 紧 ， 而 且 那 也 是 条 精神 上 的 
紧 短 澡 。…… 它 一 直 提醒 我 ， 我 做 了 写 出 整洁 代码 的 承诺 。” 有 了 这 条 腕 带 ， 代 码 猴子 成 了 模 
范 童子 军 。 我 想 ， 每 位 开发 者 都 需要 这 样 一 条 腕 带 吧 ? 


Bp fa 
2009 4E 11 月 
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Good Code BAd code. 


承 Thom Holwerda $3, & http://www.osnews.com/story/19266/WTFs_m 再 制 


你 的 代码 在 哪 道 门 后 面 ? 你 的 团队 或 公司 在 哪 道门 后 面 ? 为 什么 会 在 那里 ? 只 是 一 次 普 
通 的 代码 复查 ， 还 是 产品 面世 后 才 发 现 一 连 串 严重 问题 ?我 们 是 否 在 战 战 闫 芍 地 调试 自己 之 
前 错 以 为 没 问 题 的 代码 ? 客户 是 否 在 流失 ? 经 理 们 是 否 把 我 们 有 盯 得 如 芒 刺 在 背 ? 当 事 态 变 得 
严重 起 来 ， 如 何 保证 我 们 在 那 道 正确 的 门 后 做 补救 工作 ? 答案 是 : HA (craftsmanship). 

习 艺 之 要 有 二 : 知 和 行 。 你 应 当 习 得 有 关 原 则 、 模 式 和 实践 的 知识 ， 穷 尽 应 知之 事 ， 并 
且 要 对 其 了 如 指 掌 ， 通 过 刻苦 实践 掌握 它 。 | 

我 可 以 教 你 骑 自 行车 的 物理 学 原理 。 实 际 上 ， 经 典 数学 的 表达 方式 相对 而 言 确实 简洁 明 
了 。 重 力 、 摩 擦 力 、 角 动量 、 质 心 等 ， 用 一 页 写 满 方 程式 的 纸 就 能 说 明白 。 有 了 这 些 方 程式 ， 
我 可 以 为 你 证 明 出 骑 车 完全 可 行 ， 而 且 还 可 以 告诉 你 骑 车 所 需 的 全 部 知识 。 即 便 如 此 ， 你 在 
初次 骑 车 时 还 是 会 跌倒 在 地 。 | 

编码 亦 同 此 理 。 我 们 可 以 写 下 整洁 代码 的 所 有 “感觉 良好 ”的 原则 ， 放 手 让 你 去 干 〈 换 言 
之 , 让 你 从 自行 车 上 摔 下 来 )。 那样 的 话 , 我 们 算是 哪 门 子 老师 ? 而 你 又 会 成 为 怎样 的 学 生 呢 ? 
不 ! 本 书 可 不 会 这 么 做 。 | 
学 写 整 洁 代 码 很 难 。 它 可 不 止 于 要 求 你 掌握 原则 和 模式 。 你 得 在 这 上 面 花 工夫 。 你 须 目 行 


前 言 I 


实践 ， 且 体验 自己 的 失败 。 你 须 观察 他 人 的 实践 与 失败 。 你 须 看 看 别人 是 怎样 中 勋 学 步 ， 再 转 
头 研究 他 们 的 路 数 。 你 须 看 看 别人 是 如 何 绞 尽 脑汁 做 出 决策 ， 又 是 如 何 为 错误 决策 付出 代价 。 

阅读 本 书 要 多 用 心思 。 这 可 不 是 那 种 降落 前 就 能 读 完 的 “感觉 不 错 ” 的 飞机 书 。 本 书 要 
让 你 用 功 ， 而 且 是 非常 用 功 。 如 何 用 功 ? 阅读 代码 一 一 大 量 代码 。 而 且 你 要 去 琢磨 某 段 代码 
好 在 什么 地 方 、 坏 在 什么 地 方 。 在 我 们 分 解 ， 而 后 组 合 模块 时 ， 你 得 亦 步 亦 趋 地 跟 上 。 这 得 
花 些 工 夫 ， 不 过 值得 一 试 。 | | 

本 书 大 致 可 分 为 3 个 部 分 。 前 几 章 介绍 编写 整洁 代码 的 原则 、 模 式 和 实践 。 这 部 分 有 相 
当 多 的 示例 代码 ， 读 起 来 颇具 挑战 性 。 读 完 这 几 章 ， 就 为 阅读 第 2 部 分 做 好 了 准备 。 如 果 你 
就 此 止步 ， 只 能 祝 你 好 运 啦 ! m 

第 2 部 分 最 需要 花 工 夫 。 这 部 分 包括 几 个 复杂 性 不 断 增加 的 案例 研究 。 每 个 案例 都 清理 
一 些 代 码 一 一 把 有 问题 的 代码 转化 为 问题 少 一 些 的 代码 。 这 部 分 极为 详细 。 你 的 思维 要 在 讲 d 
解 和 代码 段 之 间 跳 来 跳 去 。 你 得 分 析 和 理解 那些 代码 ,. 琢磨 每 次 修改 的 来 龙 去 脉 。 

你 付出 的 劳动 将 在 第 3 部 分 得 到 回报 。 这 部 分 只 有 一 章 ， 列 出 从 上 述 案例 研究 中 得 到 的 

启示 和 灵感 。 在 遍 览 和 清理 案例 中 的 代码 时 ， 我 们 把 每 个 操作 理由 记录 为 一 种 启示 或 灵感 。 
我 们 尝试 去 理解 自己 对 阅读 和 修改 代码 的 反应 ， 尽 力 了 解 为 什么 会 有 这 样 的 感受 、 为 什么 会 
”如 此 行事 。 结 果 得 到 了 一 套 描 述 在 编写 、 阅 读 、 清 理 代码 时 思维 方式 的 知识 库 。 
如 果 你 在 阅读 第 2 部 分 的 案例 研究 时 没有 好 好 用 功 ， 那 么 这 套 知 识 库 对 你 来 说 可 能 所 值 
无 几 。 在 这 些 案例 研究 中 ,每 次 修改 都 仔细 注 明 了 相关 启示 的 标号 。 这 些 标号 用 方 括号 标 出 ， 
à]: [H22]。 由 此 你 可 以 看 到 这 些 启 示 在 何 种 环境 下 被 应 用 和 编写 。 启 示 本 身 不 值钱 ， 启 示 与 
案例 研究 中 清理 代码 的 具体 决策 之 间 的 关系 才 有 价值 。 

如 果 你 跳 过 案例 研究 部 分 ， 只 阅读 了 第 1 部 分 和 第 3 部 分 ， 那 就 不 过 是 又 看 了 一 本 关于 
写 出 好 软件 的 “感觉 不 错 ” 的 书 。 但 如 果 你 肯 花 时 间 琢 磨 那些 案例 ， 亦 步 亦 趋 一 一 站 在 作者 
的 角度 ， 和 迫使 自己 以 作者 的 思维 路 径 考 虑 问题 ， 就 能 更 深刻 地 理解 这 些 原则 、 模 式 、 实 践 和 

启示 。 这 样 的 话 ， 就 像 一 个 熟练 地 掌握 了 骑 车 的 技术 后 ， 目 行车 就 如 同 其 身体 的 延伸 部 分 那 
FF; 对 你 来 说 ， 本 书 所 介绍 的 整洁 代码 的 原则 、 模 式 、 实 践 和 启示 就 成 为 了 本 身 具 有 的 技艺 ， 
”而 不 再 是 “感觉 不 错 ” 的 知识 。 | 

E 
感谢 两 位 艺术 家 Jennifer Kohnke 和 Angela Brooks. Jennifer 绘制 了 每 章 起 始 处 创意 新 颖 、 
效果 惊人 的 插图 ， 以 及 Kent Beck, Ward Cunningham, Bjarne Stroustrup. Ron Jeffries. Grady 
Booch, Dave Thomas. Michael Feathers 和 我 本 人 的 肖像 。 

Angela 绘制 了 文中 那些 精致 的 插图 。 这 些 年 她 为 我 画 了 一 些 画 ， 包 括 Agile Software 
- Development: Principles, Patterns, and Practices (中 译 版 《敏捷 软件 开发 : 原则 、 模 式 与 实践 》) 
_ 一 书 中 的 大 量 插图 。 她 是 我 的 长 女 ， 常 给 我 带 来 极 大 的 愉悦 。 | 











封面 的 图 片 是 M104， 草帽 星系 (The Sombrero Galaxy). M104 坐落 于 处 女 座 ( Virgo), 
距 地 球 仅 3000 万 光 年 。 其 核心 是 一 个 质量 超大 的 黑洞 ， 有 100 万 个 太阳 那么 重 。 

这 幅 图 是 否 让 你 想起 了 Klingon 星球 ( 克 林 贡 ) “的 卫星 Praxis 〈 普 拉 西 斯 ) 爆炸 的 事 ? 
我 清楚 地 记得 ， 在 《 星 舰 迷航 YI》 中， 大 爆炸 之 后 碎片 四 溅 ， 飞 舞 出 一 个 赤道 光环 的 场景 。 
至 此 ， 光 环 就 成 为 科幻 电影 中 爆炸 场景 的 必然 产物 了 。 甚 至 就 在 《 星 舰 迷 航 》 系 列 电影 的 后 
续 情 节 中 ，Alderaan (BARR) 的 爆炸 也 有 类 似 场景 出 现 。 

环绕 M104 的 光环 是 什么 造成 的 ? 它 为 何 会 有 如 此 巨大 的 膨胀 率 和 如 此 明亮 而 微小 的 内 
Ek? 在 我 看 来 ， 仿 佛 那 位 于 中 心 位 置 的 黑洞 勃然 大 怒 ， 向 星系 的 中 心 扔 出 了 一 个 3 万 光 年 大 
的 洞 一 般 。 在 这 场 宇宙 大 崩塌 所 及 范围 之 内 的 居民 全 都 大 难 临 头 了 。 

超大 质量 的 黑洞 以 星体 为 食 , 将 星体 的 相当 部 分 质量 转 
换 为 能 量 。 方 程式 E = MC 已 经 足够 体现 杠杆 作用 了 ， 但 
当 M 有 一 颗 星体 那么 大 的 质量 时 ， 看 吧 ! 在 那 巨 兽 酒 足 饭 
饱 之 前 , 有 多 少 星体 会 一 头 撞 进 它 的 胃 里 ? 核心 部 分 空洞 的 
大 小 ， 是 否 说 明了 些 什么 昵 ? 

封面 上 的 M104 图 片 , 是 用 来 自 于 哈 勃 望远镜 的 那 幅 落 
名 的 可 见 光 相片 (上 图 ) 和 Spitzer (斯 比 泽 ) 轨道 探测 器 最 
新 的 红外 影像 (下 图 ) 组 合 而 成 。 

在 红外 影像 中 , 光环 中 的 热 粒子 闪光 着 穿 过 了 中 心 膨胀 
体 。 这 两 幅 影像 组 合 起 来 ， 显 现 出 我 们 从 未 见 过 的 景象 ， 展 。 对 面 图 片 ， 来 自 斯 比 泽 太 空 望远镜 
示 了 久远 之 前 曾 熊熊 燃烧 的 火海 。 








' 系列 剧 《 星 舰 迷航 》(Star Trek) 中 的 故事 情节 ， Praxis 星 爆炸 ， 由 此 导致 联邦 和 Klingon 达成 首次 和 平 协议 。 
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阅读 本 书 有 两 种 原因 第 一 ， 你 是 个 程序 员 ， 第 二 ， 你 想 成 为 更 好 的 程序 员 。 很 好 。 我 
要 更 好 的 程序 员 。 


2 第 1 章 整洁 代码 


这 是 本 有 关 编 写 好 程序 的 书 。 它 充斥 着 代码 。 我 们 要 从 各 个 方向 来 考察 这 些 代码 。 从 顶 
向 下 ， 从 底 往 上 ， 从 里 而 外 。 读 完 后 ， 就 能 知道 许多 关于 代码 的 事 了 。 而 且 ， 我 们 还 能 说 出 
好 代码 和 糟糕 的 代码 之 间 的 差异 。 我 们 将 了 解 到 如 何 写 出 好 代码 。 我 们 也 会 知道 ， 如 何 将 精 
糕 的 代码 改 成 好 代码 。 


11 要 有 代码 


有 人 也 许 会 以 为 ， 关 于 代码 的 书 有 点 儿 落 后 于 时 代 一 一 代码 不 再 是 问题 ， 我 们 应 当 关 注 
模型 和 需求 。 确 实 ， 有 人 说 过 我 们 正在 临近 代码 的 终结 点 。 很 快 ， 代 码 就 会 自动 产生 出 来 ， 
不 需要 再 人 工 编写 。 程 序 员 完全 没 用 了 ， 因 为 商务 人 士 可 以 从 规约 直接 生成 程序 。 

扯淡 ! 我 们 永远 抛 不 掉 代码 ， 因 为 代码 呈现 了 需求 的 细节 。 在 菜 些 层面 上 ， 这 些 细节 无 
法 被 忽略 或 抽象 ， 必 须 明 确 之 。 将 需求 明确 到 机 器 可 以 执行 的 细节 程度 , 就 是 编程 要 做 的 事 。 
而 这 种 规约 正 是 代码 。 | 

我 期 望 语 言 的 抽象 程度 继续 提升 。 我 也 期 望 领域 特定 语言 的 数量 继续 增加 。 那 会 是 好 事 一 
桩 。 但 那 终结 不 了 代码 。 实 际 上 ， 在 较 高 层次 上 用 领域 特定 语言 撰写 的 规约 也 将 是 代码 ! 它 也 
得 严谨 、 精 确 、 规 范 和 详细 ， 好 让 机 器 理解 和 执行 。 

那 帮 以 为 代码 终 将 消失 的 伙计 ， 就 像 是 巴 望 着 发 现 一 种 无 规范 数学 的 数学 家 们 一 般 。 他 
们 巴 望 着 ， 总 有 一 天 能 创造 出 某 种 机 器 ， 我 们 只 要 想 想 、 嘴 都 不 用 张 就 能 叫 它 依 计 行 事 。 那 
机 器 要 能 透彻 理解 我 们 ， 只 有 这 样 ， 它 才能 把 含糊 不 清 的 需求 翻译 为 可 完美 执行 的 程序 ， 精 
确 满足 需求 。 | | 

这 种 事 永远 不 会 发 生 。 即 便 是 人 类 ， 倾 其 全 部 的 直觉 和 创造 力 ， 也 造 不 出 满足 客户 模糊 

觉 的 成 功 系 统 来 。 如 果 说 需求 规约 原则 教 给 了 我 们 什么 ， 那 就 是 归 置 良好 的 需求 就 像 代码 
RER, bf 8 作为 代码 的 可 执行 测试 来 使 用 。 

记 住 ， 代码 确 然 是 我 们 最 终 用 来 表达 需求 的 那 种 语言 。 我 们 可 以 创造 各 种 与 需求 接近 的 
语言 。 我 们 可 以 创造 帮助 把 需求 解析 和 汇 整 为 正式 结构 的 各 种 工具 。 然 页， 我 们 永远 无 法 抛 
弃 必 要 的 精确 性 一 一 所 以 代码 永存 。 


1.2 糟糕 的 代码 


最 近 我 在 读 Kent Beck 著 Implementation Patterns〔 中 译 版 《实现 模式 》) 一 书 的 序言 。 
他 这 样 写 道 :“…… 本 书 基于 一 种 不 太 牢 靠 的 前 提 : 好 代码 的 确 重要 ……” 这 前 提 不 牢靠 ? 我 


"Rut, [Beck07]。 


Kai 我 认为 这 是 该 领域 最 强 固 、 最 受 文 持 、 最 被 强调 的 前 提 了 我 
想 Kent 也 知道 )。 我 们 知道 好 代码 重要 ， 是 因为 其 短缺 实在 困扰 了 我 
TAA. 

20 世纪 80 年 代 末 ， 有 家 公司 写 了 个 很 流行 的 杀手 应 用 ， 许 多 专 
业 人 士 都 买 来 用 。 然 后 ， 发 布 周期 开始 拉 长 。 缺 陷 总 是 不 能 修复 。 装 ” SRE qu 
载 时 间 越 来 越久 ， 骨 省 的 几率 也 越 来 越 大 。 至 今 我 还 记得 自己 在 某 天 ARN 
泪 丧 地 关 掉 那个 程序 ， 从 此 再 不 用 它 。 在 那 之 后 不 入， 该 公司 就 关门 ST 
KS. | | 
20 年 后 ， 我 见 到 那 家 公司 的 一 位 早期 雇员 ， 问 他 当年 发 生 了 什么 
事 。 他 的 回答 叫 我 愈 发 丽 惧 起 来 。 原 来 ， 当 时 他 们 赶 着 推出 产品 ， 代 码 写 得 乱七八糟 。 特 性 
越 加 越 多 ， 代 码 也 越 来 越 烂 ， 最 后 再 也 没 法 管理 这 些 代 码 了 。 是 粳 糕 的 代码 毁 了 这 家 公司 。 

你 是 否 曾 为 糟糕 的 代码 所 深 深 困扰 ? 如 果 你 是 位 有 氮 儿 经 验 的 程序 员 ， 定 然 多 次 遇 到 过 
这 类 困境 。 我 们 有 专用 来 形容 这 事 的 词 : 沼泽 (wading)。 我 们 趟 过 代码 的 水 域 。 我 们 穿 过 灌 
木 密布 、 瀑 布 暗藏 的 沼泽 地 。 我 们 拼命 想 找 到 出 路 ， 期 望 有 点 什么 线索 能 启发 我 们 到 底 发 生 
了 什么 事 ; 但 目光 所 及 ， 只 是 越 来 越 多 死 气 沉沉 的 代码 。 

你 当然 曾 为 糟糕 的 代码 所 困扰 过 。 那 么 一 一 为 什么 要 写 糟糕 的 代码 呢 ? 

是 想 快 点 完成 吗 ? 是 要 赶 时 间 吗 ? 有 可 能 。 或 许 你 觉得 自己 要 干 好 所 需 的 时 间 不 够 ; 假 
使 花 时 间 清 理 代码 ， 老 板 就 会 大 发 雷霆 。 或 许 你 只 是 不 耐烦 再 搞 这 套 程 序 ， 期 望 早点 结束 。 
或 许 你 看 了 看 自己 承诺 要 做 的 其 他 事 , 意识 到 得 赶紧 弄 完 手 上 的 东西 , 好 接着 做 下 一 件 工作 。 
这 种 事 我 们 都 干 过 。 

”我 们 都 曾经 上 曼 一 眼 自己 亲手 造成 的 混乱 ， 决 定 弃 之 而 不 顾 ， 走 癌 新 一 天 。 我 们 都 曾经 看 
到 自己 的 烂 程序 居然 能 运行 ， 然 后 断言 能 运行 的 烂 程序 总 比 什么 都 没有 强 。 我 们 都 曾经 说 过 
有 朝 一 日 再 回头 清理 。 当 然 ， 在 那些 日 子 里 ， 我 们 都 没 听 过 勒 布 朗 (LeBlanc) 法 则 : HAS 
于 永 不 (Later equals never ) 
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一 只 要 你 干 过 两 三 年 编程 ， 就 有 可 能 曾 被 某 人 的 糟糕 的 代码 绊 倒 过 。 如 果 你 编程 不 止 两 三 
年 ， 也 有 可 能 被 这 种 代码 拖 过 后 腿 。 进 度 延 缓 的 程度 会 很 严重 。 有 些 团队 在 项 目 初期 进展 迅 
;得 有 那么 一 两 年 的 时 间 却 慢 如 蜗 行 。 对 代码 的 每 次 修改 都 影响 到 其 他 两 三 处 代码 。 修 改 
VDE. .每 次 添加 或 修改 代码 ， 都 得 对 那 堆 扭 纹 柴 了 然 于 心 ,这样 才能 往 上 扔 更 多 的 扭 纹 柴 。 
这 团 乱 麻 越 来 越 大 ， 再 也 无 法 理 清 ， 最 后 束手无策 。 

“了 戎 着 混乱 的 增加 ， 团 队 生 产 力也 持续 下 降 ， 趋 向 于 零 。 当 生产 力 下 降 时 ， 管 理 层 就 只 有 
METAT: 增加 更 多 人 手 到 项 目 中 ， 期 望 提升 生产 力 。 可 是 新 人 并 不 熟悉 系统 的 设计 。 
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他 们 搞 不 清楚 什么 样 的 修改 符合 设计 意图 ， 什 么 样 的 修改 违背 设计 意图 。 而且， 他 们 以 及 团 
队 中 的 其 他 人 都 背负 着 提升 生产 力 的 可 怕 压 力 。 于 是 ， 他 们 制造 更 多 的 混乱 ， 驱 动 生产 力 向 
零 那 端 不 断 下 降 。 如 图 1-1 所 示 。 





时 间 
图 1-1 和 生产力 vs. 时间 


1.3.1 ”华丽 新 设计 


最 后 ， 开 发 团队 造反 了 ,他 们 告诉 管理 层 , 再 也 无 法 在 这 令 人 生 大 的 代码 基础 上 做 开发 。 
他 们 要 求 做 全 新 的 设计 。 管 理 层 不 愿意 投入 资源 完全 重启 炉灶 ， 但 他 们 也 不 能 否认 生产 力 低 
得 可 怕 。 他 们 只 好 同意 开发 者 的 要 求 ， 授 权 去 做 一 套 看 上 去 很 美的 华丽 新 设计 。 

于 是 就 组 建 了 一 支 新 军 。 谁 都 想 加 入 这 个 团队 ， 因 为 它 是 张 日 纸 。 他 们 可 以 重新 来 过 ， 搞 出 
点 真正 漂亮 的 东西 来 。 但 只 有 最 优秀 、 最 聪明 的 家 伙 被 选中 。 其 余人 等 则 继续 维护 现 有 系统 。 

现在 有 两 支队 伍 在 竞赛 了 。 新 团队 必须 搭建 一 套 新 系统 ， 要 能 实现 旧 系统 的 所 有 功能 
丸 外 ， 还 得 跟 上 对 旧 系 统 的 持续 改动 。 在 新 系统 功能 足以 抗衡 上 昌 系 统 之 前 ， 管 理 层 不 会 替换 
掉 旧 系统 。 | 

竞赛 可 能 会 持续 极 长 时 间 。 我 就 见 过 延续 了 十 年 之 久 的 。 到 了 完成 的 时 候 ， 新 团队 的 老 
成 员 早已 不 知 去 向 ， 而 现 有 成 员 则 要 求 重 新 设计 一 套 新 系统 ， 因 为 这 套 系统 太 烂 了 

委 全 你 经 历 过 哪 必 是 一 小 和 我 痰 到 的 这 种 事 ， 那 么 你 一 定 知道 ， 花 时 间 保持 代码 束 泪 
但 有 关 效 率 ， 还 有 关 生 存 。 


1.3 己 ”态度 


你 是 否 遇 到 过 某 种 严重 到 要 花 数 个 星期 来 做 本 来 只 需 数 小 时 即 可 完成 的 事 的 混乱 状况 ? 
你 是 否 见 过 本 来 只 需 做 一 行 修改 ， 结 果 却 涉及 上 百 个 模块 的 情况 ? 这 种 事 太 常见 了 。 

怎么 会 发 生 这 种 事 ? 为 什么 好 代码 会 这 么 快 就 变质 成 糟糕 的 代码 ? 理由 多 得 很 。 我 们 
抱怨 需求 变化 背离 了 初期 设计 。 我 们 哀叹 进度 太 紧 张 ， 没 法 干 好 活 。 我 们 把 问题 归咎 于 那 
些 昌 剧 的 经 理 、 苛 求 的 用 户 、 没 用 的 营销 方式 和 那些 电话 消毒 剂 。 不 过 ， 亲爱 的 呆 伯 特 
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(Dilbert) ， 我 们 是 自作 自 受 2。 我 们 太 不 专业 了 。 

这 话 可 不 太 中 听 。 怎么 会 是 自作 自 受 呢 ? 难道 不 关 需 求 的 事 ? 难道 不 关 进 度 的 事 ? 难道 不 关 
那些 章 经 理 和 没 用 的 营销 手段 的 事 ? 难道 他 们 就 不 该 负 点 责 吗 ? 

不 。 经 理 和 营销 人 员 指望 从 我 们 这 里 得 到 必须 的 信息 ， 然 后 才能 做 出 承诺 和 保证 ， 即 便 
他 们 没 开口 问 ， 我 们 也 不 该 闭 于 告知 自己 的 想法 。 用 户 指望 我 们 验证 需求 是 否 都 在 系统 中 实 
现 了 。 项 目 经 理 指望 我 们 遵守 进度 。 我 们 与 项 目的 规划 脱 不 了 干系 ,对 失败 负 有 极 大 的 责任 ; 
特别 是 当 失 败 与 糟糕 的 代码 有 关 时 尤为 如 此 ! 

“且慢 !” 你 说 。“ 不 听 经 理 的 ， 我 就 会 被 炒 鲈鱼 ”多半 不 会 。 多 数 经 理想 要 知道 实情 ， 
即便 他 们 看 起 来 不 喜欢 实情 。 多 数 经 理想 要 好 代码 ， 即 便 他 们 总 是 阁 缠 于 进度 。 他 们 会 奋力 
卫 护 进度 和 需求 ， 那 是 他 们 该 干 的 。 你 则 当 以 同等 的 热情 卫 护 代码 。 

再 说 明白 些 ， 假 使 你 是 位 医生 ， 病 人 请 求 你 在 给 他 做 手术 前 别 洗手 ， 因 为 那 会 花 太 多 时 间 ， 
你 会 照办 吗 ?? 本 该 是 病人 说 了 血 ， 但 医生 却 绝对 应 该 拒绝 遵从 。 为 什么 ? 因为 医生 比 病人 更 了 
解 疾病 和 感染 的 风险 。 医 生 如 果 按 病人 说 的 办 ， 就 是 一 种 不 专业 的 态度 〈 更 别 说 是 犯罪 了 )。 

同 理 ， 程 序 员 遵 从 不 了 解 混乱 风险 的 经 理 的 意愿 ， 也 是 不 专业 的 做 法 。 
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程序 员 面临 着 一 种 基础 价值 谜 题 。 有 那么 几 年 经 验 的 开发 者 都 知道 , 之 前 的 混乱 拖 了 自己 的 
后 腿 。 但 开发 者 们 背负 期 限 的 压力 ， 只 好 制造 混乱 。 简 言 之 ， 他 们 没 花 时 间 让 自己 做 得 更 快 ! 
真正 的 专业 人 士 明 白 ， 这 道 谜 题 的 第 二 部 分 说 错 了 。 —— 2 
会 立刻 拖 慢 你 ， 叫 你 错 i 
-可 能 保持 代码 整洁 。 


1.34 ”整洁 代码 的 艺术 


假设 你 相信 混乱 的 代码 是 祸首 ， 假 设 你 接受 做 得 快 的 唯一 方法 是 保持 代码 整洁 的 说 法 ， 
你 一 定 会 自 间 :“ 我 怎么 才能 写 出 整洁 的 代码 ? ”不 过 ， AN AEA FURY aM SA f] XL, 
尝试 去 写 整洁 代码 就 毫 无 所 益 ! 

坏 消 息 是 写 整洁 代码 很 像 是 绘画 。 多 数 人 都 知道 一 幅 画 是 好 还 是 坏 。 但 能 分 辨 优 劣 并 不 








WE: 著名 IT 讽刺 漫画 。 i 

”译注 :原文 为 But the fault, dear Dilbert, is not in our stars, but in ourselves. 脱 胎 自 莎士比亚 戏剧 《 玫 力 斯 凯撒 》 第 一 幕 第 
二 场 山 些 斯 的 台词 The fault, dear Brutus, is not in our stars, but in ourselves, that we are underlings. ( 若 我 们 受 人 所 制 ， 亲 爱 
的 勃 鲁 托 斯 ， 那 错 也 在 我 们 身上 ， 不 能 怪罪 命运 。) 

` ERE: 1847 年 Ignaz Semmelweis〈 伊 纳 效 ， 塞 麦 尔 维 斯 ) 提 出 医生 应 洗手 的 建议 时 ， 唱 到 了 反对 ， 人 们 认为 医生 太 忙 ， 
接 诊 时 无 暇 洗手 。 
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表示 懂得 绘画 。 能 分 辩 整 洁 代 码 和 及 及 代码 ， 也 不 意味 着 会 写 整洁 代码 ! 

— 写 整洁 代码 ， 需 要 遵循 大 量 的 小 技巧 ， 贯 彻 刻 苦 习 得 的 “整洁 感 ”。 这 种 “代码 感 ”就 是 
关键 所 在 。 有 些 人 生 而 有 之 。 有 些 人 费 点 劲 才能 得 到 。 它 不 仅 让 我 们 看 到 代码 的 优 务 ， 还 予 
我 们 以 借 戒 规 之 力 化 劣 为 优 的 攻略 。 

缺乏 “代码 感 ” 的 程序 员 ， 看 混乱 是 混乱 ， 无 处 着 手 。 有 “代码 感 ” 的 程序 员 能 从 混乱 
中 看 出 其 他 的 可 能 与 变化 。“ 代 码 感 ”帮助 程序 员 选 出 最 好 的 方案 , 并 指导 程序 员 制 订 修改 行 
动 计划 ， 按 图 索 骇 。 | 

简 言 之 ， 编 写 整洁 代码 的 程序 员 就 像 是 艺术 家 ， 他 能 用 一 系列 变换 把 一 块 白板 变 作 由 优 
雅 代 码 构成 的 系统 。 | 
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有 多 少 程序 员 ， 就 有 多 少 定义 。 所 以 我 只 询问 了 一 些 非常 知名 且 经 验 丰 富 的 程序 员 

Bjarne Stroustrup, C++ 语言 发 明 者 ， C++ Programming 
Language (中 译 版 《C++ 程序 设计 语言 》) 一 书 作 者 。 

JUS UU S SENA, (NIRE HUS HART, HRB 
难以 隐藏 ;尽量 减少 依赖 关系 ， 使 之 便于 维护 ; 依据 某 种 分 层 战 
略 完善 错误 处 理 代 码 ; 性 能 调 至 最 优 ， 省 得 引诱 别人 做 没 规矩 的 
优化 ， 搞 出 一 堆 混乱 来 。 整 洁 的 代码 只 做 好 一 件 事 。 

Bjarne 用 了 “优雅 ”一 词 。 说 得 好 ! 我 MacBook 上 的 词 
典 提供 了 如 下 定义 : 外 表 或 举止 上 令 人 愉悦 的 优美 和 雅 观 ; 
令 人 愉悦 的 精致 和 简单 。 注 意 对 “从 悦 ” 一 词 的 强调 。Bjarne 

显然 认为 整洁 的 代码 读 起 来 令 人 愉悦 。 读 这 种 代码 ， 就 像 见 
性 工 和 美的 音乐 人 者 设计 和 民 的 汽车 一 般 ， 让 你 会 心 一 笑 。 
次 提 及 。 这 话 出 自 C++ 发 明 者 之 口 ， 或 许 并 不 出 奇 不 
{aise RAMEE. 被 浪费 掉 的 运算 周期 并 不 雅 观 ， 并 不 令 人 愉悦 。 留 意 
Bjarne 怎么 描述 那 种 不 雅 观 的 结果 。 他 用 了 “引诱 ”这 个 词 。 诚 哉 斯 言 。 糟 糕 的 代码 引发 
混乱 ! 别人 修改 糟糕 的 代码 时 ， 往 往 会 越 改 越 烂 。 

务实 的 Dave Thomas 和 Andy Hunt 从 另 一 角度 阐述 了 这 种 情况 。 他 们 提 到 破 窗 理论 '。 窗 户 
破损 了 的 建筑 让 人 觉得 似乎 无 人 照管 。 于 是 别人 也 再 不 关心 。 他 们 放任 窗户 继续 破损 。 最终 自己 
也 参加 破坏 活动 ， 在 外 墙 上 涂鸦 ， 任 垃圾 堆积 。 一 扇 破 损 的 窗户 开辟 了 大 厦 走 向 倾 颓 的 道路 。 

Bjarne 也 提 到 完善 错误 处 理 代码 。 往 深 处 说 就 是 在 细节 上 论 心 思 。 敷衍 了 事 的 错误 处 理 
代码 只 是 程序 员 忽视 细节 的 一 种 表现 。 此 外 还 有 内 存 泄漏 ， 还 有 竞 态 条 件 代码 。 还 有 前 后 不 








' RYE: http://www.pragmaticprogrammer.com/booksellers/2004-12.html。 
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一 致 的 命名 方式 。 结 果 就 是 凸现 出 整洁 代码 对 细节 的 重视 。 

Bjarne 以 “整洁 的 代码 只 做 好 一 件 事 ”结束 论断 。 毋 庸 置疑 ， 软 件 设计 的 许多 原则 最 终 
都 会 归结 为 这 句 警 语 。 有 那么 多 人 发 表 过 类 似 的 言论 。 糟糕 的 代码 想 做 太 多 事 ， 它 意图 混乱 、 
目的 含混 。 整 洁 的 代码 力求 集中 。 每 个 函数 、 每 个 类 和 每 个 模块 都 全 神 贯 注 于 一 事 ， 完 全 不 
受 四 周 细节 的 干扰 和 污染 。 


Grady Booch Object Oriented Analysis and 
Design with Applications (中 译 版 《面向 对 象 分 析 与 设 
计 》) 一 书 作 者 。 c 

整洁 的 代码 简单 直接 。 整 洁 的 代码 如 同 优 美的 散文 。 

整 洛 的 代码 从 不 隐藏 设计 者 的 意图 ， 充 满 了 干净 利落 的 
BEAR, 了 当 的 控制 语句 。 


Grady 的 观点 与 Bjarne 的 观点 有 类 似 之 处 ， 但 他 从 
“可 读 性 的 角度 来 定义 。 我 特别 喜欢 “整洁 的 代码 如 同 优 
美的 散文 ”这 种 看 法 。 想 想 你 读 过 的 某 本 好 书 。 回 忆 一 
_ 下， 那些 文字 是 如 何在 脑 中 形成 影像 ! 就 像 是 看 了 场 电影 ， 对 吧 ? 还 不 止 ! 你 还 看 到 那些 人 

YD, VARESE, AWARE SSA. | 
“阅读 整洁 的 代码 和 阅读 Lord of the Rings (中 译 版 《指环 王 》) 自然 不 同 。 不 过 ， 仍 有 可 
-类 比 之 处 。 如 同一 本 好 的 小 说 般 ， 整 洁 的 代码 应 当 明 确 地 展现 出 要 解决 问题 的 张力 。 它 应 当 

“将 这 种 张力 推 至 高 潮 ， 以 某 种 显而易见 的 方案 解决 问题 和 张力 ， 使 读者 发 出 “ 啊 哈 ! 本 当 如 

RCT” AA RRA 

me STD Grady 所 谓 “ 干 净利 落 的 抽象 ”(crisp abstraction)， 乃 是 绝妙 的 矛盾 修辞 法 。 毕 况 

sp. 几 乎 就 是 “具体 ”(concrete) 的 同义词。 我 MacBook 上 的 词典 这 样 定 义 crisp 一 词 : 果 
决绝 ， 就 事 论 事 ， 没 有 犹豫 或 不 必要 的 细节 。 该 词 还 是 承载 了 有 


信息 。 .代码 应 当 讲 述 事实 ， 不 引 人 猜 测 。 它 只 该 包含 必需 之 物 。 读 者 应 当 感 受到 我 们 的 
























' Dave Thomas, OTI 公司 创始 人 ，Eclipse 战略 


的 代码 应 可 由 作者 之 外 的 开发 者 阅读 和 增补 。 
测试 和 验收 测试 。 它 使 用 有 意义 的 命名 。 Min 
多 种 做 一 件 事 的 途径 。 它 只 有 尽量 少 的 依赖 关系 ， 
要 明确 地 定义 和 提供 清晰 、 尽 量 少 的 API。 代码 应 通过 其 
有 达 含 义 ， 因 为 不 同 的 语言 导致 并 非 所 有 必需 信息 均 可 
码 自身 清晰 表达 . 
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Dave 老大 在 可 读 性 上 和 Grady 持 相 同 观点 ， 但 有 一 个 重要 的 不 同 之 处 。Dave 断言 ， 整 
洁 的 代码 便于 其 他 人 加 以 增补 。 这 看 似 显 而 易 见 ， EE REEREBWUBSAS 
E AE EC BIAS, 

Dave 将 整洁 系 于 测试 之 上 ! 要 在 十 年 之 前 ， 这 会 让 人 大 跌眼镜 。 .但 测试 驱动 开发 (Test 
Driven Development) 已 在 行业 中 造成 了 深远 影响 ， 成 为 基础 规程 之 一 。Dave 说 得 对 。 没 有 
测试 的 代码 不 干净 。 不 管 它 有 多 优雅 ， 不 管 有 多 可 读 、 多 易 理 解 ， 微 乎 测试 ， 其 不 洁 亦 可 
知 也 。 

Dave AKIR “RED”. BA, Bee Stink, MA 软件 起 人 们 就 在 反 
复 强 调 这 一 点 。 越 小 越 好 。 

Dave 也 提 到 , 代码 应 在 字面 上 表达 其 含义 。 这 一 观点 源 自 Knuth 的 “字面 编程 ”(literate 
programming)“。 结 论 就 是 应 当 用 人 类 可 读 的 方式 来 写 代 码 。 


Michael Feathers, Working Effectively with Legacy 
Code 中 译 版 《修改 代码 的 艺术 》) 一 书 作者 。 

我 可 以 列 出 我 留意 到 的 整洁 代码 的 所 有 特点 ， 但 其 中 有 
一 条 是 根本 性 的 。 整 洁 的 代码 总 是 看 起 来 像 是 某 位 特别 在 意 
它 的 人 写 的 。 几 乎 没有 改进 的 余地 。 代码 作者 什么 都 想到 了 ， 
如 果 你 企图 改进 它 ， 总 会 回 到 原点 ， 赞 叹 某 人 留 给 你 的 代码 
一 一 全 心 投入 的 某 人 留 下 的 代码 。 


一 言 以 蔽 之 : 在 意 。 这 就 是 本 书 的 题 旨 所 在 。 或 许 该 加 
个 副标题 ， 如 何在 意 代码 。 

Michael 一 针 见 血 。 整 洁 代 码 就 是 作者 着 力 照 料 的 代码 。 
有 人 曾 花 时 间 让 它 保持 简单 有 序 。 他 们 适当 地 关注 到 了 细节 。 
他 们 在 意 过 。 


Ron Jeffries, Extreme Programming Installed (中 译 
版 《极限 编程 实施 》) 以 及 Extreme Programming 
Adventures in CH (中 译 版 《C# 极 限 编程 探险 》》 作 者 。 

Ron 初 入 行 就 在 战略 空军 司令 部 (Strategic Air 
Command) 编写 Fortran 程序 ， 此 后 几乎 在 每 种 机 器 上 编 
写 过 每 种 语言 的 代码 。 他 的 言论 值得 咀嚼 。 


近年 来 ， 我 开始 研究 贝克 的 简单 代码 规则 ， 差不多 也 
都 琢磨 透 了 。 简 单 代 码 ， 依 其 重要 顺序 : 








! 原 注 ，[Knuth92]。 
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e 能 通过 所 有 测试 ; 

e 没有 重复 代码 ; 

© 体现 系统 中 的 全 部 设计 理念 ; 

e 包括 尽量 少 的 实体 ， 比 如 类 、 方 法 、 浮 数 等 。 

在 以 上 诸 项 中 ， 我 最 在 意 代码 重复 。 如 果 同 一 段 代 码 反 复出 现 ， 就 表示 某 种 想法 未 在 代 
码 中 得 到 良好 的 体现 。 我 尽力 去 找 出 到 底 那 是 什么 ， 然 后 再 尽力 更 清晰 地 表达 出 来 。 

在 我 看 来 ， 有 意义 的 命名 是 体现 表达 力 的 一 种 方式 ， 我 往往 会 修改 好 几 次 才 会 定 下 名 字 
来 。 借 助 Eclipse 这 样 的 现代 编码 工具 ， 重 命名 代价 极 低 ， 所 以 我 无 所 顾忌 。 然而， 表达 力 还 
不 只 体现 在 命名 上 。 我 也 会 检查 对 象 或 方法 是 否 想 做 的 事 太 多 。 如 果 对 象 功 能 太 多 ， 最 好 
是 切 分 为 两 个 或 多 个 对 象 。 如 果 方 法 功能 太 多 ， 我 总 是 使 用 抽取 手段 (Extract Method) € 
构 之 ， 从 而 得 到 一 个 能 较为 清晰 地 说 明 自 身 功能 的 方法 ， 以 及 另外 数 个 说 明 如 何 实 现 这 些 功 

消除 重复 和 提高 表达 力 让 我 在 整洁 代码 方面 获 益 良 多 ， 只 要 铭记 这 两 点 ， 改 进 脏 代码 时 
就 会 大 有 不 同 。 不 过 ， 我 时 常 关注 的 另 一 规则 就 不 太 好 解释 了 。 

这 么 多 年 下 来 ， 我 发 现 所 有 程序 都 由 极为 相似 的 元 素 构成 。 例 如 “在 集合 中 查找 某 物 ”。 
不 管 是 历 员 记录 数据 库 还 是 名 - 值 对 哈 项 表 ， 或 者 菜 类 条 目的 数组 , 我们 都 会 发 现 自己 想 要 从 
集合 中 找到 某 一 特定 条 目 。 一 旦 出 现 这 种 情况 ， 我 通常 会 把 实现 手段 封装 到 更 抽象 的 方法 或 
类 中 。 这 样 做 好 处 多 多 。 

可 以 先 用 某 种 简单 的 手段 ， 比 如 哈 希 表 来 实现 这 一 功能 ， 由 于 对 搜索 功能 的 引用 指向 了 
我 那个 小 小 的 抽象 ， 就 能 随 需 应 变 ， 修 改 实现 手段 。 这 样 就 既 能 快速 前 进 ， 又 能 为 未 来 的 修 
改 预 留 余 地 。 

另外 ， 该 集合 抽象 常常 提醒 我 留意 “真正 ”在 发 生 的 事 ， 避 免 随意 实现 集合 行为 ， 因 为 
我 真正 需要 的 不 过 是 某 种 简单 的 查找 手段 。 

减少 重复 代码 , ,提高 表达 力 ， 提 早 构 建 简单 抽象 。 这 就 是 我 写 整洁 代码 的 方法 。 

Ron 以 蜜 察 数 段 文字 概括 了 本 书 的 全 部 内 容 。 不 要 重复 代码 ， 只 做 一 件 事 ， 表 达 力 ， 小 
规模 抽象 。 该 有 的 都 有 了 。 | 


Ward Cunningham, Wiki 发 明 者 , eXtreme Programming 
(极限 编程 ) 的 创始 人 之 一 ，Smalltalk 语言 和 面向 对 象 的 思想 
领袖 。 所 有 在 意 代 码 者 的 教父 。 

| 如 果 每 个 例 程 都 让 你 感到 深 合 己 意 ， 那 就 是 整洁 代码 。 
如 果 代 码 让 编程 语言 看 起 来 像 是 专 为 解决 那个 问题 而 存在 ， 
就 可 以 称 之 为 漂亮 的 代码 。 | 


这 种 说 法 很 Ward。 它 教 你 听 了 之 后 就 点 头 ， 然 后 继续 
听 下 去 。 如 此 在 理 ， 如 此 浅显 ， 绝 不 故 作 高 深 。 你 大 概 以 为 
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此 言 深 合 已 意 吧 。 再 走 近 点 看 看 。 | 

“…… 深 合 己 意 ”。 你 最 近 一 次 看 到 深 合 已 意 的 模块 是 什么 时 候 ? 模块 多 半 都 繁复 难 解 
吧 ? 难道 没有 触犯 规则 吗 ? 你 不 是 也 曾 挣扎 着 想 抓 住 些 从 整个 系统 中 散 洲 而 出 的 线索 ， 编 织 
进 你 在 读 的 那个 模块 吗 ? 你 最 近 一 次 读 到 某 段 代码 、 并 且 如 同 对 Ward PUPA IONS 般 对 这 
段 代 码 点 头 ， 是 什么 时 候 的 事 了 ? 

Ward 期 望 你 不 会 为 整洁 代码 所 震惊 。 你 无 需 花 太 多 力气 。 那 代码 就 是 深 合 你 意 。 它 明确 、 
简单 、 有 力 。 每 个 模块 都 为 下 一 个 模块 做 好 准备 。 每 个 模块 都 告诉 你 下 一 个 模块 会 是 怎样 的 。 
整洁 的 程序 好 到 你 根本 不 会 注意 到 它 。 设 计 者 把 它 做 得 像 一 切 其 他 设计 般 简 单 。 

AB Ward AR “R” KELWA? 我 们 都 曾 面临 语言 不 是 为 要 解决 的 问题 所 设计 的 
困境 。 但 Ward 的 说 法 又 把 球 踢 回 我 们 这 边 。 他 说 ， 漂 亮 的 代码 让 编程 语言 像 是 专 为 解决 那 

个 问题 而 存在 ! 所 以 ， 让 语言 变 得 简单 的 责任 就 在 我 们 身上 了 ! 当心 ， 语 言 是 冥 殴 不 化 的 ! 
是 程序 员 让 语言 显得 简单 。 


1.4 思想 流派 


我 (BHA MAE ARRANGE? 在 我 眼中 整洁 代码 是 什么 
ibd ? 本 书 将 以 详细 到 吓 死人 的 程度 告诉 你 , 我 和 我 的 同道 对 整 
洁 代 码 的 看 法 。 我 们 会 告诉 你 关于 整洁 变量 名 的 想法 ,关于 整洁 
ptos, 关于 整洁 类 的 想法 ， 如 此 等 等 。 我们 视 这 些 观点 为 
当然 ， 且 不 为 其 逆 耳 而 致歉 。 对 我 们 而 言 ， 在 职业 生涯 的 这 个 阶 
段 ， 这 些 观 点 确 属 当 然 ， 也 是 我 们 整洁 代码 派 的 在 由 。 
”武术 家 从 不 认同 所 谓 最 好 的 武术 ， 也 不 认同 所 谓 绝 招 。 武术 
”大 师 们 常常 创建 自己 的 流派 ， 聚 徒 而 授 。 因 此 我 们 才 看 到 格雷 西 
家 族 在 巴西 开创 并 传授 的 格雷 西 柔 术 (Gracie Jiu Jistu)， 看 到 奥 
山 龙 峰 ( Okuyama Ryuho) 在 东京 开创 并 传授 的 八 光 流 柔 术 
(Hakkoryu Jiu Jistu)， 看 到 李小龙 (Bruce Lee》 在 美国 开创 并 传授 的 截 产道 (Jeet Kune Do). 
弟子 们 沉浸 于 创始 人 的 授 业 。 他 们 全 心 师 从 某 位 师傅 ， 排 斥 其 他 师 传 。 弟 子 有 所 成 就 后 ， 可 
以 转投 男 一 位 师傅 ， 扩 展 自己 的 知识 与 技能 。 有 些 弟子 最 终 百 炼 成 钢 ， 创 出 新 招数 ， 开 宗 立 派 。 
任何 门派 都 并 非 绝对 正确 。 不 过 ， 身 处 某 一 门派 时 ， 我 们 总 以 其 所 传 之 技 为 善 。 归 根 结 
底 ， 练 习 八 光 流 柔 术 或 截 产道 ， 自 有 其 善 法 ， 但 这 并 不 能 否定 其 他 门派 所 授 之 法 。 
可 以 把 本 书 看 作 是 对 象 导 师 (Object Mentor) ;整洁 代码 派 的 说 明 。 里 面 要 传授 的 就 是 我 
们 勤 操 已 艺 的 方法 。 如 果 你 遵从 这 些 教诲 ， 你 就 会 如 我 们 一 般 乐 受 其 瘟 ， 你 将 学 会 如 何 编写 





”译注 ， 本 书 主要 作者 Robert C.Martin 开办 的 技术 咨询 和 培训 公司 。 
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Hy E EERSTEN 样 专 
业 。 你 有 必要 也 向 他 们 和 学习。 

实际 上 ， 书 中 很 多 建议 都 存在 争议 。 或 许 你 并 不 完全 同意 这 些 建议 。 你 可 能 会 强烈 反对 
”其 中 一 些 建议 。 这 样 挺 好 的 。 我 们 不 能 要 求 做 最 终 权 威 。 另 外 一 方面 ， 书 中 列 出 的 建议 ， 旋 
是 我 们 长 久 苦 思 、 从 数 十 年 的 从 业经 验 和 无 数 尝试 与 错误 中 得 来 。 无 论 你 同意 与 否 ， 如 果 你 
人 就 真 该 自己 害 腺 。 


1.5 ”我 们 是 作者 


Javadoc 中 的 @author 字段 告诉 我 们 自己 是 什么 人 。 我 们 是 作者 。 作 者 都 有 读者 。 实际 上 ， 
作者 有 责任 与 读者 做 良好 沟通 。 PRBS TN, 记得 自己 是 作者 ， 要 为 评判 你 工作 的 
读者 写 代 码 。 

你 或 许 会 问 : 代码 真正 “ 读 ” 的 成 分 有 多 少 昵 ? 难道 力量 主要 不 是 用 在 “ 写 ” 上 吗 ? 

你 是 否 玩 过 “编辑 器 回放 ”? 20 世纪 80. 90 ER, Emac 之 类 编辑 器 记录 每 次 击 键 动作 。 
你 可 以 在 一 小 时 工作 之 后 ， 回放 击 键 过 程 ， 就 像 是 看 一 部 高 速 电 影 。 我 这 么 做 过 ， 结 果 很 有 趣 。 
回放 过 程 显示 ， 多 数 时 间 都 是 在 滚动 屏幕 、 浏 览 其 他 模块 ! 


$6, Shit AFB. 
他 向 下 滚动 到 要 修改 的 函数 。 
他 停 下 来 考虑 可 以 做 什么 。 
O 哦 ， 他 滚动 到 模块 顶端 ， 检 查 变量 初始 化 
^o 现在 他 回 到 修改 处 ， 开 始 键入 ， 
O E, RUBUS T AEN M A E 
“他 重新 键入 . 
.他 又 删除 了 ! | 
Kr 他 键入 了 一 半 什么 东西 ， 又 删除 掉 。 
二 ”他 滚动 到 调用 要 修改 函数 的 另 一 函数 ， 看 看 是 怎么 调用 的 。 
他 回 到 修改 处 ， 重 新 键入 刚才 删 掉 的 代码 。 
”他 停 下 来 。 
他 再 一 次 删 掉 代码 ! 
goo 他 打开 另 一 个 窗口 ， 查 看 别 的 子 类 。 那 是 个 复 载 函 数 吗 ? 









E 你 该 明白 了 。 读 与 写 花 费时 间 的 比例 超过 10:1。 写 新 代码 时 ， 我 们 一 直 在 读 旧 代码 . 
既然 比例 如 此 之 高 ， 我 们 就 想 让 恋 的 过 程 变 得 轻松 ， 即 便 那 会 使 得 编写 过 程 更 难 。 没 可 
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能 光 写 不 读 ， 所 以 使 之 易 读 实际 也 使 之 易 写 ， 


这 事 概 无 例外 。 不 读 周边 代码 的 话 就 没 法 写 代码 。 编 写 代码 的 难度 ， 取决 于 读 周边 代码 
的 难度 。 要 想 干 得 快 ， 要 想 早点 做 完 ， 要 想 轻 松 写 代码 ， 先 让 代码 易 读 吧 。 ! 


16 童子 军 军 规 


光 把 代码 写 好 可 不 够 。 必 须 时 时 保持 代码 整洁 。 我 们 都 见 过 代码 随时 间 流 逝 而 腐 坏 。 我 
们 应 当 更 积极 地 阻止 腐 坏 的 发 生 。 
借用 美国 童子 军 一 条 简单 的 军 规 ， 应 用 到 我 们 的 专业 领域 : 


让 营地 比 你 来 时 更 干净 。 

如 果 每 次 签 入 时 ， 代 码 都 比 签 出 时 干净 ， 那 么 代码 就 不 会 腐 坏 。 清 理 并 不 一 定 要 花 多 少 
功夫 ， 也 许 只 是 改 好 一 个 变量 名 ， 拆 分 一 个 有 点 过 长 的 函数 ， 消 除 一 点 所 重复 代码 ， 清 理 一 
MRE if A) 

你 想 要 为 一 个 代码 随时 间 流 逝 而 越 变 越 好 的 项 目 工 作 吗 ? 你 还 能 相信 有 其 他 更 专业 的 做 
法 吗 ? 难道 持续 改进 不 是 专业 性 的 内 在 组 成 部 分 吗 ? 


1.7 ”前传 与 原则 


从 许多 角度 看 ， 本 书 都 是 我 2002 年 写 那 本 Agile Software Development: Principles, 
Patterns, and Practices (中 译 版 《敏捷 软件 开发 : 原则 、 模 式 与 实践 》 简称 PPP) 的 “前 传 ”。 
PPP 关注 面向 对 象 设计 的 原则 ， 以 及 专业 开发 者 采用 的 许多 实践 方法 。 假 如 你 没 读 过 PPP, 
你 会 发 现 它 像 这 本 书 的 延续 。 如 果 你 读 过 ， 会 发 现 那 本 书 的 主张 在 代码 层面 于 本 书 中 回 啊 。 

在 本 书 中 ， 你 会 发 现 对 不 同 设计 原则 的 引用 ， 包 括 单一 权 责 原则 (Single Responsibility 
Principle，SRP)、 开 放 闭 合 原则 (Open Closed Principle，OCP) 和 依赖 倒置 原则 (Dependency 
Inversion Principle, DIP) 等 。 


1.8 小结 


艺术 书 并 不 保证 你 读 过 之 后 能 成 为 艺术 家 ， 只 能 告诉 你 其 他 艺术 家 用 过 的 工具 、 技 术 和 


! Bk: 摘自 Robert Stephenson Smyth Baden-Powell (英国 人 ， 童 子 军 创始 者 ) 对 童子 军 的 遗言 :“ 努 力 ， 让 世界 比 你 来 时 
FYB eee” | 
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思维 过 程 。 本 书 同样 也 不 担保 让 你 成 为 好 程序 员 。 它 不 担保 能 给 你 “代码 感 ” 它 所 能 做 的 ， 
只 是 展示 好 程序 员 的 思维 过 程 ， 还 有 他 们 使 用 的 技巧 、 技 术 和 工具 。 

和 艺术 书 一 样 ， 本 书 也 充满 了 细节 。 代 码 会 很 多 。 你 会 看 到 好 代码 ， 也 会 看 到 糟糕 的 代 
码 。 你 会 看 到 糟糕 的 代码 如 何 转 化 为 好 代码 。 你 会 看 到 启发 、 规 条 和 技巧 的 列表 。 你 会 看 到 


一 个 又 一 个 例子 。 但 最 终结 果 取决 于 你 自己 。 
还 记得 那个 关于 小 提琴 家 在 去 表演 的 路 上 迷路 的 老 笑 话 吗 ?他 在 街角 拦住 一 位 长 者 ， 问 
他 怎么 才能 去 卡耐基 音乐 厅 (Carnegie Hall)。 长 者 看 了 看 小 提琴 家 ， 又 看 了 看 他 手中 的 琴 ， 


WE: WEBA. BT, BAA” 
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码 所 在 目录 命名 。 我 们 给 jar 文件、war 文件 和 ear 文件 命名 。 我 们 命名 、 命 名 ， 不 断 命名 。 
既然 有 这 么 多 命名 要 做 ， 不 妨 做 好 它 。 下 文 列 出 了 取 个 好 名 字 的 几 条 简单 规则 。 


22 ”名副其实 


名 副 其 实说 起 来 简单 。 我 们 想 要 强调 ， 这 事 很 严肃 。 选 个 好 名 字 要 花 时 间 ， 但 省 下 来 的 
时 间 比 花 掉 的 多 。 注 意 命名 ， 而 且 一 旦 发 现 有 更 好 的 名 称 ， 就 换 掉 旧 的 。 这 么 做 ， 读 你 代码 
HA (BRAC) Mee IPL. | 

变量 、 函 数 或 类 的 名 称 应 该 已 经 答复 了 所 有 的 大 问题 。 它 该 告诉 你 , ET A RETE, 
它 做 什么 事 ， 应 该 怎么 用 。 如 果 名 称 需要 注释 来 补充 ， 那 就 不 算是 名 副 其 实 。 

int d; // 消逝 的 时 间 ， 以 日 计 | 

名 称 d 什么 也 没 说 明 。 它 没有 引起 对 时 间 消 逝 的 感觉 ， 更 别 说 以 日 计 了 。 我 们 应 该 选择 
指明 了 计量 对 象 和 计量 单位 的 名 称 : 

int elapsedTimeInDays; 

int daysSinceCreation; 


int daysSinceModification; 
int fileAgeInDays; 


选择 体现 本 意 的 名 称 能 让 人 更 容易 理解 和 修改 代码 。 下 列 代码 的 目的 何在 ? 


public List<int[]> getThem() { 
List<int[]> listl = new ArrayList<int[]>(); 
for (int[] x : theList) 
if (x[0] == 4) 
listl.add(x); 





return listl; 


为 什么 难以 说 明 上 列 代码 要 做 什么 事 ? 里 面 并 没有 复杂 的 表达 式 。 空 格 和 缩 进 中 规 中 矩 。 
只 用 到 三 个 变量 和 两 个 常量 。 甚至 没有 涉及 任何 其 他 类 或 多 态 方法 ， 只 是 《或 者 看 起 来 是 ) 
一 个 数组 的 列表 而 已 。 

问题 不 在 于 代码 的 简洁 度 ， 而 是 在 于 代码 的 模糊 度 ; 即 上 下 文 在 代码 中 未 被 明确 体现 的 
程度 。 上 列 代 码 要 求 我 们 了 解 类 似 以 下 问题 的 答案 ; 

(1) theList 中 是 什么 类 型 的 东西 ? 

(2) theList 零下 标 条 目的 意义 是 什么 ? 

(3) 值 4 的 意义 是 什么 ? 

(4) 我 怎么 使 用 返回 的 列表 ? 

问题 的 答案 没 体现 在 代码 段 中 ， TEREE 它们 该 在 的 地 方 。 比 方 说 ， 我 们 在 开发 一 种 扫 


23 避免 误导 17 


雷 游戏 ， 我 们 发 现 ， 盘 面 是 名 为 theList 的 单元 格 列表 ， 那 就 将 其 名 称 改 为 gameBoard。 
” ”盘面 上 每 个 单元 格 都 用 一 个 简单 数组 表示 。 我 们 还 发 现 ， 零 下 标 条 目 是 一 种 状态 值 ， 而 
该 种 状态 值 为 4 表示 “已 标记 ”。 只 要 改 为 有 意义 的 名 称 ， 代 码 就 会 得 到 相当 程度 的 改进 : 
public List<int[]> getFlaggedCells() { 
List<int[]> flaggedCells = new ArrayList<int[]>(); 
for (int[] cell : gameBoard) 
if (cell[STATUS VALUE] == FLAGGED) 
flaggedCells.add(cell); 


return flaggedCells; 
() | 


注意 ， 代 码 的 简洁 性 并 未 被 触及 。 运 算 符 和 和 常量 的 数量 全 然 保持 不 变 ， 藤 套数 量 也 全 然 
保持 不 变 。 但 代码 变 得 明确 多 了 。 | 

还 可 以 更 进一步 ， 不 用 int 数组 表示 单元 格 ， 而 是 男 写 一 个 类 。 该 类 包括 一 个 名 副 其 实 
的 函数 〈 称 为 isFlagged)， 从 而 掩盖 住 那个 魔术 数 。 于 是 得 到 函数 的 新 版 本 : 


public List<Cell> getFlaggedCells() { 
List<Cell> flaggedCells = new ArrayList«Cell»(); 
for (Cell cell : gameBoard) 
if (cell.isFlagged()) 
flaggedCells.add(cell); 
return flaggedCells; 
) 


只 要 简单 改 一 下 名 称 ， 就 能 轻易 知道 发 生 了 什么 。 这 就 是 选用 好 名 称 的 力量 。 


23 ”避免 误导 


程序 员 必 须 避 免 留 下 掩藏 代码 本 意 的 错误 线索 。 应 当 避 免 使 用 与 本 意 相 悖 的 词 。 例 如 ， 
hp. aix 和 sco 都 不 该 用 做 变量 名 ， 因 为 它们 都 是 UNIX 平台 或 类 UNIX 平台 的 专 有 和 名称。 即 
便 你 是 在 编写 三 角 计 算 程序 ，hp 看 起 来 是 个 不 错 的 缩写 ”， 但 那 也 可 能 会 提供 错误 信息 。 

别 用 accountList 来 指称 一 组 账号 ， 除 非 它 真 的 是 List 类 型 。List 一 词 对 程序 员 有 特殊 意 
义 。 如 果 包 纳 账 号 的 容器 并 非 真是 个 List， 就 会 引起 错误 的 判断 。 所 以 ， 用 accountGroup 或 
bunchOfAccounts， 甚 至 直接 用 accounts 都 会 好 一 些 。 | 

提防 使 用 不 同 之 处 较 小 的 名 称 。 想 区 分 模块 中 某 处 的 XYZControllerFor 
EfficientHandlingOfStrings 和 男 一 处 的 XYZControllerForEffcientStorageOfStrings， 会 花 多 长 时 
间 呢 ? 这 两 个 词 外 形 实在 太 相 似 了 。 


! 译注， 即 表示 已 标记 的 4. 
?译注 : 即 hypotenuse 的 缩写 。 
? fk. 如 后 文 提 到 的 ， 即 便 容器 就 是 个 List， 最 好 也 别 在 名 称 中 写 出 容器 类 型 名 。 
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以 同样 的 方式 拼写 出 同样 的 概念 才 是 信息 。 拼 写 前 后 不 一 RIES: ;我 们 很 享受 现代 
Java 编程 环境 的 自动 代码 完成 特性 。 键 入 某 个 名 称 的 前 几 个 字母 ， 按 二 F 某 个 热 键 组 合 - Can 
果 有 的 话 ), 就 能 得 到 一 列 该 名 称 的 可 能 形式 。 假 如 相似 的 名 称 依 字母 顺序 放 在 一 起 ， 且 .差异 
很 明显 ， 那 就 会 相当 有 助 益 ， 因为 程序 员 多 半 会 压根 不 看 你 的 详细 注释 、 BETERA 的 方 
法 列表 就 直接 看 名 字 挑 一 个 对 象 。 

误导 性 名 称 真正 可 怕 的 例子 ， 是 用 小 写字 母 1 和 大 写字 母 0 ege, 大 是 在 组 合 使 
用 的 时 候 。 当 然 ， 问 题 在 于 它们 看 起 来 完全 像 是 常量 “过 ”和 “ 零 " 0 


int a = l; 
if (0 == 1) 
a = Ol; 

else 
l = 01; 


读者 可 能 会 认为 这 纯 属 虚构 ， 但 我 们 确 曾 见 过 充斥 这 类 玩意 的 代码 。 有 一 次 ， 代 码 作 
者 建议 用 不 同 字体 写 变量 名 ， 好 显得 更 清楚 些 ， 不 过 这 种 方案 得 要 通过 口头 和 书面 传递 给 
未 来 所 有 的 开发 者 才 行 。 后 来 ， 只 是 做 了 简单 的 重 命名 操作 ， 就 解决 了 问题， 而 且 也 没 搞 
出 别 的 事 。 





2.4 ”做 有 意义 的 区 分 


如 果 程 序 员 只 是 为 满足 编译 器 或 解释 器 的 需要 而 写 代 码 ， SE Wm ES] 为 同 
一 作用 范围 内 两 样 不 同 的 东西 不 能 重 名 ， 你 可 能 会 随手 改 掉 
其 中 一 个 的 名 称 。 有 时 于 脆 以 错误 的 拼写 充 数 ， 结 果 就 是 出 
现在 更 正 拼写 错误 后 导致 编译 器 出 错 的 情况 。 

光 是 添加 数字 系列 或 是 废话 远 远 不 够 ， 即 便 这 足以 让 编 
译 器 满意 。 如 果 名 称 必 须 相 异 ， 那 其 意思 也 应 该 不 同 才 对 。 

以 数字 系列 命名 Cal, a2, vee aN) 是 依 义 命名 的 对 立 
(Hl. 这 样 的 名 称 纯 属 误导 一 一 完全 没有 提供 正确 信息 ，; 没有 提供 导向 作者 意图 的 线索 。 试看 : 


public static void copyChars(char al[], char a2[]) { 
for (int i = 0; i < al.length; i++) { 
a2[i] = al[i]; 
3} 
} 
如 果 参 数 名 改 为 source 和 destination， 这 个 函数 就 会 像样 许多 。 
废话 是 另 一 种 没 意 义 的 区 分 。 假 设 你 有 一 个 Product 类 。 如 果 还 有 一 个 ProductInfo 或 





' 原 注 : 例如， 就 因为 class 已 有 他 用 ， 就 给 一 个 变量 命名 为 klass， 这 真是 可 怕 的 做 法 。 
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ProductData 类 ， 那 它们 的 名 称 虽 然 不 同 , 意思 却 无 区 别 。Info 和 Data HA a. an 和 the 一 样 ， 
是 意义 含混 的 废话 。 

注意 ， 只 要 体现 出 有 意义 的 区 分 ， 使 用 a 和 the 这 样 的 前 缀 就 没 错 。 例 如 ， 你 可 能 把 a 
用 在 域内 变量 ,而 把 the 用 于 函数 参数 '。 但 如 果 你 已 经 有 一 个 名 为 zork 的 变量 ， 又 想 调 用 一 
个 名 为 theZork 的 变量 ， 麻 烦 就 来 了 。 

废话 都 是 元 余 。Variable 一 词 永 远 不 应 当 出 现在 变量 名 中 。Table 一 词 永 远 不 应 当 出 现在 
表 名 中 。NameString Sth Name 好 吗 ? 难道 Name 会 是 一 个 浮 点 数 不 成 ? 如 果 是 这 样 ， 就 触 
犯 了 关于 误导 的 规则 。 设 想 有 个 名 为 Customer 的 类 ,还 有 一 个 名 为 CustomerObject 的 类 。 区 
别 何 在 呢 ? 哪 一 个 是 表示 客户 历史 支付 情况 的 最 佳 途径 ? 
ut 有 个 应 用 反映 了 这 种 状况 。 为 当事者 讳 ， 我 们 改 了 一 下 ， 不 过 犯错 的 代码 的 确 就 是 这 个 

样子 ， | | 


getActiveAccount (); 
getActiveAccounts(); 
getActiveAccountInfo(); 


程序 员 怎 么 能 知道 该 调用 哪个 函数 呢 ? 
如 果 缺 少 明确 约定 ， 变 量 moneyAmount 就 与 money 没 区 别 ，customerInfo 与 customer 


^ 没 区 别 ，accountData 与 account 没 区 别 ，theMessage 也 与 message 没 区 别 。 要 区 分 名 称 ， 就 





要 以 读者 人 鉴别 不 同 之 处 的 方式 来 区 分 。 


2.5 ”使 用 读 得 出 来 的 名 称 


“人 类 长 于 记 忆 和 使 用 单词 。 大 脑 的 相当 一 部 分 就 是 用 来 容纳 和 处 理 单词 的 。 单 词 能 读 得 
ee ee 块 地方 用 来 处 理 言语 , 若 不 善 加 利用 ,实在 是 种 耻辱 。 
2 如果 名 称 读 不 出 来 ,讨论 的 时 候 就 会 像 个 傻 鸟 。“ 哎 ,这儿 ， 鼻 涕 阿 三 喜 揭 踢 (bee cee arr 
hree cee enn tee) EA, A HRCA (pee ess zee kyew) 整数， 看 见 没 ? ”这 不 是 小 事 ， 
为 编程 本 就 是 一 种 社会 活动 。 





E Td 
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a 













pu NAH, 程序 里 面 写 了 个 genymdhms《〈 生 成 日 期 ， 年 、 B. D. D. 4r. $5, dii] 
: 一 般 读 作 “gen why emm dee aich emm ess” “。 我 有 个 见 字 照 读 的 恶习 ， 于 是 开口 就 念 
zem * gen-yah-mudda-hims ". 后 来 好 些 设 计 师 和 分 析 师 都 有 样 学 样 ， 听 起 来 傻乎乎 的 。 我 们 知道 
故 ， 所 以 会 觉得 很 搞笑 。 搞 笑 归 搞 笑 ， 实 际 是 在 强 忍 糟 糕 的 命名 。 在 给 新 开发 者 解释 变量 





, 鲍 壹 大 权 惯 于 在 CH+ 中 这 样 做 ， 但 后 来 放弃 了 ， 因 为 现代 IDE 使 这 种 做 法 变 得 没 必要 了 。 
BCR3CNT 的 读音 。 
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的 意义 时 ， 他 们 总 是 读 出 傻乎乎 的 自 造 词 ， 而 非 恰当 的 英语 词 。 比 较 


" class DtaRcrd102 ( 
private Date genymdhms; 
private Date modymdhms; 
private final String pszqint = "102"; 
/* 4 | 
和 


class Customer { 
private Date generationTimestamp; | 
private Date modificationTimestamp;; 
private final String recordId - "102"; 
GP hee SY 
}; 
“现在 读 起 来 就 像 人 话 了 :“ 喂 ，Mikey， 看 看 这 条 记录 ! ÆRE (generation timestamp) ' 


被 设置 为 明天 了 ! 不 能 这 样 吧 ? ” 


2.6 ”使 用 可 搜索 的 名 称 


单字 母 名 称 和 数字 常量 有 个 问题 ， 就 是 很 难 在 一 大 篇 文字 中 找 出 来 。 

找 MAX CLASSES PER STUDENT 很 容易 ， 但 想 找 数字 7 就 麻烦 了 ， 它 可 能 是 某 些 文 
件 名 或 其 他 常量 定义 的 一 部 分 ， 出 现在 因 不 同意 图 而 采用 的 各 种 表达 式 中 。 如 果 该 常量 是 个 
长 数字 ， 又 被 人 错 改过 ， 就 会 逃 过 搜索 ， 从 而 造成 错误 。 | 

同样 ，e 也 不 是 个 便于 搜索 的 好 变量 名 。 它 是 英文 中 最 常用 的 字母 ， 在 每 个 程序 、 每 段 代码 
中 都 有 可 能 出 现 。 由 此 而 见 ， 长 名 称 胜 于 短 名 称 ， 搜 得 到 的 名 称 胜 于 用 自 造 编码 代 写 就 的 名 称 。 

窃 以 为 单字 母 名 称 仅 用 于 短 方 法 中 的 本 地 变量 。 名 称 长 短 应 与 其 作用 域 大 小 相对 应 
[IN5]。 若 变量 或 常量 可 能 在 代码 中 多 处 使 用 ， 则 应 赋 其 以 便于 搜索 的 名 称 。 再 比较 


for (int j=0; j<34; j++) | 
S += (t[j]*4)/5; 
) 


和 


int realDaysPerIdealDay = 4; 

const int WORK DAYS PER WEEK = 5; 

int sum = 0; 

for (int j=0; j < NUMBER OF TASKS; j++) { 
int realTaskDays = taskEstimate[j] * realDaysPerIdealDay; 
int realTaskWeeks = (realdays / WORK DAYS PER WEEK); 
sum += realTaskWeeks;. 

) 


' 译注 : 读 到 generation timestamp 时 ， 立 刻 就 能 与 代码 中 的 generationTimestamp 变量 对 应 上 。 
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注意 ， 上 面 代码 中 的 sum 并 非特 别 有 用 的 名 称 ， 不 过 它 至 少 搜 得 到 。 采 用 能 表达 意图 的 
RR, 貌似 拉 长 了 函数 代码 , 但 要 想 想 看 ,WORK_DAYS_PER_WEEK 要 比 数字 5 好 找 得 多 ， 
. 而 列表 中 也 只 剩 下 了 体现 作者 意图 的 名 称 。 


2.7 ”避免 使 用 编码 


编码 已 经 太 多 ， 无 谓 再 自 找 麻烦 。 把 类 型 或 作用 域 编 进 名 称 里 面 ， 徒 然 增 加 了 解码 的 

负担 。 没 理由 要 求 每 位 新 人 都 在 弄 清 要 应 付 的 代码 之 外 〈 那 算是 正常 的 )， 还 要 再 搞 懂 另 一 

O 种 编码 “语言 ”>， 这 对 于 解决 问题 而 言 ， 纯 属 多 余 的 负担 。 带 编码 的 名 称 通常 也 不 便 发 音 ， 
”容易 打 错 。 | 


 e7. 匈牙利 语 标记 法 


在 往昔 名 称 长 短 很 要 命 的 时 代 , 我 们 毫 无 必要 地 破坏 了 不 编码 的 规矩 ,如 今后 悔 不 迭 。 

_ Fortran 语言 要 求 首 字母 体现 出 类 型 ， 导 致 了 编码 的 产生 。BASIC 早期 版 本 只 允许 使 用 
”一 个 字母 再 加 上 一 位 数字 。 匈 牙 利 语 标记 法 (Hungarian Notation, HN) 将 这 种 态势 愈 演 

愈 烈 。 
| 在 Windows 的 C 语言 API 的 时 代 ，HN 相当 重要 ， 那 时 所 有 名 称 要 么 是 个 整数 句柄 ， 要 
“ 么 是 个 长 指针 或 者 void 指针 ， 要 不 然 就 是 string 的 几 种 实现 (有 不 同 的 用 途 和 属性 ) 之 一 。 
“” 那 时 候 编译 器 并 不 做 类 型 检查 ， 程 序 员 需 要 匈牙利 语 标记 法 来 帮助 自己 记 住 类 型 。 
" ”现代 编程 语言 具有 更 丰富 的 类 型 系统 ， 编 译 器 也 记得 并 强制 使 用 类 型 。 而 且 ， 人 们 趋向 
>. 于 使 用 更 小 的 类 、 更 短 的 方法 ， 好 让 每 个 变量 的 定义 都 在 视野 范围 之 内 。 
EO lava 程序 员 不 需要 类 型 编码 。 对 象 是 强 类 型 的 ， 代 码 编辑 环境 已 经 先进 到 在 编译 开始 前 
就 侦 测 到 类 型 错误 的 程度 ! 所 以 ， 如 今 HN 和 其 他 类 型 编码 形式 都 纯 属 多 余 。 它 们 增加 了 修 
后 改变 量 、 函 数 或 类 的 名 称 或 类 型 的 难度 。 它 们 增加 了 阅读 代码 的 难度 。 它 们 制造 了 让 编码 系 
和 统 误导 读者 的 可 能 
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` ^ PhoneNumber phoneString; ` 
(04/4. 类 型 变化 时 ， 名 称 并 不 变化 ! 
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E: 
























”也 不 必用 m_ 前 统 来 标明 成 员 变 量 。 应 当 把 类 和 函数 做 得 足够 小 ， 消 除 对 成 员 前 级 的 需 
你 应 当 使 用 某 种 可 以 高 亮 或 用 颜色 标 出 成 员 的 编辑 环境 。 


public class Part { 
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private String m dsc; // The textual description 
void setName(String name) { 
m dsc - name; 
) 
) 


public class Part ( 
String description; 
void setDescription(String description) ( 
this.description - description; 
) 
) 


此 外 , 人 们 会 很 快 学 会 无 视 前 级 (或 后 级 ), 只 看 到 名 称 中 有 意义 的 部 分 。 代码 读 得 越 多 ， 
眼中 就 越 没有 前 级 。 最 终 ， 前 级 变 作 了 不 入 法 眼 的 废料 ， 变 作 了 有 旧 代码 的 标志 


2.73 ”接口 和 实现 


有 时 也 会 出 现 采 用 编码 的 特殊 情形 。 比 如 ， 你 在 做 一 个 创建 形状 用 的 抽象 工厂 (Abstract 
Factory )。 该 工厂 是 个 接口 , 要 用 具体 类 来 实现 ,你 怎么 来 命名 工厂 和 具体 类 呢 ?IShapeFactory 
和 ShapeFactory 吗 ? 我 喜欢 不 加 修饰 的 接口 。 前 导 字 母 I 被 滥用 到 了 说 好 听 点 是 干扰 ， 说 难 
昕 点 根本 就 是 废话 的 程度 。 我 不 想 让 用 户 知道 我 给 他 们 的 是 接口 。 我 就 想 让 他 们 知道 那 是 个 
ShapeFactory。 如 果 接 口 和 实现 必须 选 一 个 来 编码 的 话 ， 我 宁肯 选择 实现 。ShapeFactoryImp， 
甚至 是 丑陋 的 CShapeFactory， 都 比 对 接口 名 称 编码 来 得 好 。 


2.8 ”避免 思维 映射 


不 应 当 让 读者 在 脑 中 把 你 ME QUESTIO M 这 种 问题 经 常 出 现在 选择 是 使 
用 问题 领域 术语 还 是 解决 方案 领域 术语 时 。 

单字 母 变 量 名 就 是 个 问题 。 在 作用 域 较 小 、 也 没有 名 称 冲突 时 ， 循 环 计数 器 自然 有 可 能 
被 命名 为 i 或 j 或 k。 (at TES 1!) 这 是 因为 传统 上 惯用 单字 母 名 称 做 循环 计数 器 。 
然而 , 在 多 数 其 他 情况 下 ， 单 字母 名 称 不 是 个 好 选择 ; 人 
仅仅 是 因为 有 了 a 和 b， 就 要 取 名 为 c， 实 在 并 非 像样 的 理由 。 

程序 员 通 常 都 是 聪明 人 。 聪 明 人 有 时 会 借 脑筋 急 转 弯 炫 溜 其 聪明 。 总 而 言 =>, 假使 你 记 
得 r 代表 不 包含 主机 名 和 图 式 〈scheme) 的 小 写字 母 版 url 的 话 ， 那 你 真是 太 聪 明了 。 

聪明 程序 员 和 专业 程序 员 之 间 的 区 别 在 于 ， 专 业 程序 员 了 人 解 ， 阴 确 是 王道 。 专 业 程 序 员 
善 用 其 能 ， 编 写 其 他 人 能 理解 的 代码 。 | 
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2.9 类 名 


类 名 和 对 象 名 应 该 是 名 词 或 名 词 短 语 , 如 Customer、 WikiPage、Account 和 AddressParser。 
避免 使 用 Manager、Processor、Data 或 Info 这 样 的 类 名 。 类 名 不 应 当 是 动词 。 


2.10 方法 名 


| 方法 名 应 当 是 动词 或 动词 短语 ， 如 postPayment、deletePage 或 save。 属 性 访问 器 、 修 改 
侣 和 断言 应 该 根据 其 值 命 名 ， 并 依 Javabean 标准 :加 上 get. set 和 is 前 级 。 


. string name = employee.getName(); 
customer.setName ("mike"); 
if (paycheck.isPosted())... 


重 载 构造 器 时 ， 使 用 描述 了 参数 的 静态 工厂 方法 名 。 例 如 ， 


Bebe fulcrumPoint = Complex.FromRealNumber (23.0); ; 


通常 好 于 


Complex fulcrumPoint = new Complex(23.0); 


可 以 考虑 将 相应 的 构造 器 设置 为 private， 强 制 使 用 这 种 命名 手段 。 
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- :如 果 名 称 太 要 宝 ， 那 就 只 有 同 作者 一 般 有 顷 
uem Seo. 而 且 还 是 在 他 们 记得 那个 
E 话 的 时 候 才 行 。 谁 会 知道 名 为 HolyHandGrenade? 
的 落 数 是 用 来 做 什么 的 昵 ? 没 错 ， 这 名 字 挺 伶俐 ， 
不 过 DeleteItems’ 或 许 是 更 好 的 名 称 。 宁 可 明确 ， 

co 扮 可 爱 的 做 法 在 代码 中 经 常 体现 为 使 用 从 















E : http://java.sun.com/products/javabeans/docs/spec.html. 
NE: 意 为 “圣手 手雷 ”。 
"E: BON “删除 条 目 ”。 
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WREE. Gi, SUE whack 来 表示 kill( )。 别 用 eatMyShorts( ) 这 类 与 文化 紧密 相关 的 天 


话 来 表示 abort( )。 
言 到 意 到 。 意 到 言 到 。 


242 每 个 概念 对 应 一 个 词 


给 每 个 抽象 概念 选 一 个 词 ， 并 且 一 以 贯 之 。 例 如 ， 使 用 fetch、retrieve 和 get 来 给 在 多 个 
类 中 的 同 种 方法 命名 。 你 怎么 记得 住 哪个 类 中 是 哪个 方法 呢 ? WER, KAER SER 
类 的 公司 、 机 构 或 个 人 ， 才 能 想 得 起 来 用 的 是 哪个 术语 。 否 则 ， 就 得 耗费 大 把 时 间 浏 览 各 个 
文件 头 及 前 面 的 代码 。 

Eclipse 和 IntelliJ 之 类 现代 编程 环境 提供 了 与 环境 相关 的 线索 , 比如 某 个 对 象 能 调用 的 方 
法 列表 。 不 过 要 注意 ， 列 表 中 通常 不 会 给 出 你 为 函数 名 和 参数 列表 编写 的 注释 。 如 果 参 数 名 
称 来 自 函数 声明 ， 你 就 太 垃 运 了 。 函 数 名 称 应 当 独 一 无 二 ， 而 且 要 保持 一 致 ， 这 样 你 才能 不 

车 助 多 余 的 浏览 就 找到 正确 的 方法 。 

同样 ,在 同一 堆 代 码 中 有 controller, 又 有 manager, 还 有 driver, ,就 会 令 人 困惑 ,DeviceManager 
和 Protocol-Controller 之 间 有 何 根本 区 别 ? 为 什么 不 全 用 controllers 或 managers? 他 们 都 是 
Drivers 吗 ? 这 种 名 称 ， 让 人 觉得 这 两 个 对 象 是 不 同类 型 的 ， 也 分 属 不 同 的 类 。 | 

对 于 那些 会 用 到 你 代码 的 程序 员 ， 一 以 贯 之 的 命名 法 简直 就 是 天 降 福音 。 


~ 一 ” 


2.43 BAMA 


避免 将 同一 单词 用 于 不 同 目的 。 同 一 术语 用 于 不 同 概念 ， 基 本 上 就 是 双关 语 了 。 如 果 遵 
循 “一 词 一 义 ” 规 则 ， 可 能 在 好 多 个 类 里 面 都 会 有 add 方法 。 只 要 这 些 add 方法 的 参数 列表 
和 返回 值 在 语义 上 等 价 ， 就 一 切 顺利 。 | | 

但 是 ， 可 能 会 有 人 决定 为 “保持 一 致 ”而 使 用 add 这 个 词 来 命名 ， 即 便 并 非 真 的 想 表 示 
这 种 意思 。 比 如 ,在 多 个 类 中 都 有 add 方法 ,该 方法 通过 增加 或 连接 两 个 现存 值 来 获得 新 值 。 
假设 要 写 个 新 类 ， 该 类 中 有 一 个 方法 ， 把 单个 参数 放 到 群集 (collection〉 中。 该 把 这 个 方法 
叫做 add 吗 ? RMB add 方法 保持 了 一 致 ， 但 实际 上 语义 却 不 同 ， 应 该 用 insert 
Bk append 之 类 词 来 命名 才 对 。 把 该 方法 命名 为 add， 就 是 双关 语 了 。 | 

SER SUS JI S UH ACT RARE. FUEL TARTE 5S HERILABE— BR. TUAE 


(XH, BRK. 
? RH, XEM. 
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精 竭 虑 地 研究 。 我 们 想 要 那 种 大 众 化 的 作者 尽责 写 清楚 的 平装 书 模 式 ， 我 们 不 想 要 那 种 学 者 
挖 地 三 尺 才能 明白 个 中 意义 的 学 院 派 模 式 。 


244 ”使 用 解决 方案 领域 名 称 


记 住 只 有 程序 员 才 会 读 你 的 代码 。 所 以 ， 尽 管用 那些 计算 机 科学 (Computer Science, CS) 
术语 、 算 法 名 、 模 式 名 、 数 学 术语 吧 。 依 据 问 题 所 涉 领域 来 命名 可 不 算是 聪明 的 做 法 ， 因 为 不 该 
让 协作 者 老 是 跑 去 问 客户 每 个 名 称 的 含义 ， 其 实 他 们 早 该 通过 另 一 名 称 了 解 这 个 概念 了 。 

对 于 熟悉 访问 者 (VISITOR) 模式 的 程序 来 说 ， 名 称 AccountVisitr 富有 意义 。 哪 个 程 
序 员 会 不 知道 JobQueue HRA? 程序 员 要 做 太 多 技术 性 工作 。 给 这 些 事 取 个 技术 性 的 名 
称 ， 通 常 是 最 靠 谱 的 做 法 。 


2.15 ”使 用 源 自 所 涉 问题 领域 的 名 称 


如 有 果 不 能 用 程序 员 熟 悉 的 术语 来 给 手头 的 工作 命名 ， 就 采用 从 所 涉 问题 领域 而 来 的 名 称 
吧 。 全 少 ， 负 责 维 护 代 码 的 程序 员 就 能 去 请 教 领域 专家 了 。 — 

优秀 的 程序 员 和 设计 师 ， 其 工作 之 一 就 是 分 离 解 决 方案 领域 和 问题 领域 的 概念 。 与 所 涉 
问题 领域 更 为 贴近 的 代码 ， 应 当 采 用 源 自问 题 领域 的 名 称 。 


2.16 添加 有 意义 的 语 境 


很 少 有 名 称 是 能 自我 说 明 的 一 一 多 数 都 不 能 。 反 之 ， 你 需要 用 有 良好 命名 的 类 、 函 数 或 
名 称 空间 来 放置 名 称 ， 给 读者 提供 语 境 。 如 果 没 这 么 做 ， 给 名 称 添 加 前 级 就 是 最 后 一 招 了 。 

设想 你 有 名 为 firstName、lastName、street、houseNumber、city、state 和 zipcode 的 变量 。 
当 它 们 搁 一 块 儿 的 时 候 ， 很 明确 是 构成 了 一 个 地 址 。 不 过 ， 假 使 只 是 在 某 个 方法 中 看 见 孤 零 
零 一 个 state RENE? 你 会 理所当然 推断 那 是 某 个 地 址 的 一 部 分 吗 ? | 

可 以 添加 前 缀 addrFirstName. addrLastName. addrState 等 ， 以 此 提供 语 境 。 至 少 ， 读 者 
会 明白 这 些 变 量 是 某 个 更 大 结构 的 一 部 分 。 当 然 ， 更 好 的 方案 是 创建 名 为 Address 的 类 。 这 
样 ， 即 便 是 编译 器 也 会 知道 这 些 变量 隶属 某 个 更 大 的 概念 了 。 

看 看 代码 清单 2-1 中 的 方法 。 以 下 变量 是 否 需要 更 有 意义 的 语 境 呢 ? 函数 名 仅 给 出 了 部 
分 语 境 ， 算 法 提供 了 剩 下 的 部 分 。 遍 览 函 数 后 ， 你 会 知道 number, verb 和 pluralModifier 这 
三 个 变量 是 “ 测 估 ”信息 的 一 部 分 。 不 幸 的 是 这 语 境 得 靠 读 者 推断 出 来 。 第 一 眼看 到 这 个 方 
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法 时 ， 这 些 变 量 的 含义 完全 不 清楚 。 
代码 清单 -1 ” 语 境 不 明确 的 变量 


private void printGuessStatistics(char candidate, int count) ( 
String number; 
String verb; 
String pluralModifier; 
if (count == 0) { 


number = "no"; 

verb = "are"; 

pluralModifier = "s"; 
} else if (count == 1) { 

number = "1"; 

verb = "is"; 

pluralModifier = ""; 
} else { 

number = Integer.toString (count); 

verb = "are"; 

pluralModifier = "s"; 


} 
String guessMessage = String. format ( 
"There $s $s $s$s", verb, number, candidate, pluralModifier 
); 
print (guessMessage); 


) 


上 列 函 数 有 点 儿 过 长 ， 变 量 的 使 用 贯穿 始终 。 要 分 解 这 个 函数 ， 需 要 创建 一 个 名 为 
GuessStatisticsMessage 的 类 ， 把 三 个 变量 做 成 该 类 的 成 员 字 段 。 这 样 它们 就 在 定义 上 变 作 了 
GuessStatisticsMessage 的 一 部 分 。 语 境 的 增强 也 让 算法 能 够 通过 分 解 为 更 小 的 函数 而 变 得 更 
为 干净 利落 。( 如 代码 清单 2-2 所 示 。) 


代码 清单 2-2 ”有 语 境 的 变量 


public class GuessStatisticsMessage { 
| private String number; 
private String verb; 
private String pluralModifier; 


public String make (char candidate, int count) { 
createPluralDependentMessageParts (count); 
return String.format( 
"There $s Sa $s$s", 
verb, number, candidate, pluralModifier ); 


) 


private void createPluralDependentMessageParts(int count) { 


if (count == 0) { 
thereAreNoLetters(); 

) else if (count == 1) { 
thereIsOneLetter(); 

} else ( 


thereAreManyLetters (count); 
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) 
) 


private void thereAreManyLetters(int count) { 
number = Integer.toString (count); 
verb - "are"; | 
pluralModifier = "s"; 


) 


private void thereIsOneLetter() ( 
number - "]"; 
verb - "is"; 
pluralModifier = ""; 

) 


private void thereAreNoLetters() { 
number = "no"; 
verb = "are"; 
pluralModifier = "s"; 
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设 若 有 一 个 名 为 “加 油 站 豪华 版 ”(Gas Station Deluxe) 的 应 用 ， 在 其 中 给 每 个 类 添加 
GSD 前 缀 就 不 是 什么 好 点 子 。 说 白 了 ， 你 是 在 和 自己 在 用 的 工具 过 不 去 。 输 入 G， 按 下 自动 
完成 键 ， 结 果 会 得 到 系统 中 全 部 类 的 列表 ， 列 表 恨 不 得 有 一 英里 那么 长 。 这 样 做 聪明 吗 ? 为 
什么 要 搞 得 IDE 没 法 帮助 你 ? 

再 比如 , 你 在 GSD 应 用 程序 中 的 记 账 模块 创建 了 一 个 表示 邮件 地 址 的 类 , 然后 给 该 类 命 
名 为 GSDAccountAddress 。 稍 后 ， 你 的 客户 联络 应 用 中 需要 用 到 邮件 地 址 ， 你 会 用 
GSDAccountAddress 吗 ? 这 名 字 听 起 来 没 问题 吗 ? 在 这 17 个 字母 里 面 ， 有 10 个 字母 纯 属 多 
余 和 与 当前 语 境 上 毫 无 关联 。 

只 要 短 名 称 足够 清楚 ， 就 要 比 长 名 称 好 。 别 给 名 称 添加 不 必要 的 语 境 。 

对 于 Address 类 的 实体 来 说 ，accountAddress 和 customerAddress 都 是 不 错 的 名 称 ， 不 过 用 
在 类 名 上 就 不 太 好 了 。Address 是 个 好 类 名 。 如 果 需 要 与 MAC 地 址 、 端 口 地 址 和 Web 地 址 相 区 
别 , 我 会 考虑 使 用 PostalAddress、MAC 和 URI. 这 样 的 名 称 更 为 精确 , 而 精确 正 是 命名 的 要 点 。 
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取 好 名 字 最 难 的 地 方 在 于 需要 良好 的 描述 技巧 和 共有 文化 背景 。 与 其 说 这 是 一 种 技术 、 
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商业 或 管理 问题 ， 还 不 如 说 是 一 种 教学 问题 。 其 结案 是 ， 这 个 领域 内 的 许多 人 都 没 能 学 会 做 
得 很 好 。 

我 们 有 时 会 怕 其 他 开发 者 反对 重 命名 。 如 果 讨 论 一 下 就 知道 ， 如 果 名 称 改 得 更 好 ， 那 大 
家 真 的 会 感激 你 。 多 数 时 候 我 们 并 不 记忆 类 名 和 方法 名 。 我 们 使 用 现代 工具 对 付 这 些 细节 ， 
好 让 自己 集中 精力 于 把 代码 写 得 就 像 词句 篇 章 、 至 少 像 是 表 和 数据 结构 〈( 词 名 并 非 总 是 呈现 
数据 的 最 佳 手段 )。 改 名 可 能 会 让 某 人 吃惊 ， 就 像 你 做 到 其 他 代码 改善 工作 一 样 。 别 让 这 种 事 
阻碍 你 的 前 进步 伐 。 

不 妨 试 试 上 面 这 些 规则 ， 看 你 的 代码 可 读 性 是 否 有 所 提升 。 如果 你 是 在 维护 别人 号 的 代 
码 ， 使 用 重 构 工具 来 解决 问题 。 效果 立竿见影 ， 而 且 会 持续 下 去 。 





TH 


第 








在 编程 的 早年 岁月 ， 系 统 由 程序 和 子 程序 组 成 。 后 来 ， 在 Fortran 和 PLI KER, R 
由 程序 、 子 程序 和 函数 组 成 。 如 今 ， 只 有 函数 存活 下 来 。 函 数 是 所 有 程序 中 的 第 一 组 代码 。 
本 章 将 讨论 如 何 写 好 函数 。 
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请 看 代码 清单 3-1。 在 FitNesse! 中 ， 很 难 找到 长 函数 ， 不 过 我 还 是 搜寻 到 一 个 。 它 不 光 
长 ， 而 且 代码 也 很 复杂 ， 有 大 量 字符 串 、 怪 异 而 不 显 见 的 数据 类 型 和 API。 花 3 分 钟 时 间 ， 
看 能 读 懂 多 少 ? 


代码 清单 3-1 HtrnlUtil java (FitNesse 20070619) 


public static String testableHtml( 
PageData pageData, 
boolean includeSuiteSetup 
) throws Exception ( 
WikiPage wikiPage = pageData.getWikiPage(); 
StringBuffer buffer - new StringBuffer(); 
if (pageData.hasAttribute("Test")) { 
if (includeSuiteSetup) { 
WikiPage suiteSetup - 
PageCrawlerImpl.getInheritedPage( 
SuiteResponder.SUITE SETUP NAME, wikiPage 
); 
if (suiteSetup != null) ( 
WikiPagePath pagePath - 
suiteSetup.getPageCrawler().getFullPath(suiteSetup); 
String pagePathName = PathParser.render (pagePath); 
buffer.append("!include -setup .") 
.append (pagePathName) 
.append ("Nn"); - 
) 
} 
WikiPage setup = 
PageCrawlerImpl.getInheritedPage("SetUp", wikiPage) ; 
if (setup != null) { | 
WikiPagePath setupPath - 
wikiPage.getPageCrawler() .getFullPath (setup); 
String setupPathName = PathParser.render(setupPath) ; 
buffer.append("!include -setup .") 
. append (setupPathName) 
append ("Mn") ; 
) 
) 
buffer.append(pageData.getContent ()); 
if (pageData.hasAttribute("Test")) | 
WikiPage teardown - 
PageCrawlerImpl.getInheritedPage("TearDown", wikiPage); 
if (teardown != null) { 
WikiPagePath tearDownPath - 
wikiPage.getPageCrawler().getFullPath(teardown); 
String tearDownPathName = PathParser.render (tearDownPath); 
buffer.append ("Mn") 
.append("!include -teardown .") 
.append (tearDownPathName) 
.append ("Mn") ; 


RE: 一 种 开源 测试 工具 。 见 http://www.fitnese.org. 
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if (includeSuiteSetup) { 

WikiPage suiteTeardown = 
PageCrawlerImpl.getInheritedPage( 
SuiteResponder.SUITE TEARDOWN NAME, 

wikiPage 
); 
if (suiteTeardown != null) ( 
WikiPagePath pagePath - 
suiteTeardown.getPageCrawler().getFullPath (suiteTeardown); 
String pagePathName = PathParser.render (pagePath); 
buffer.append("!include -teardown .") 
.append (pagePathName) 
.append ("Mn") ; 
) 
) 


) 
pageData.setContent (buffer.toString()); 


return pageData.getHtml (); 
) 


Tí TIX TS PR TS? 大 概 没 有 。 有 太 多 事 发 生 ， 有 太 多 不 同 层级 的 抽象 。 奇 怪 的 字符 串 
和 函数 调用 ， 混 以 双重 嵌 套 、 用 标识 来 控制 的 让 语句 等 ， 不 一 而 足 。 
不 过 ， 只 要 做 几 个 简单 的 方法 抽 离 和 重 命名 操作 ， 加 上 一 点 点 重 构 ， 就 能 在 9 行 代码 之 
.内 搞 扩 《如 代码 清单 3-2 所 示 )。 用 3 分 钟 阅读 以 下 代码 ， 看 你 能 理解 吗 ? 





代码 清单 3-2 ”HtmlUtiljava〔 重 构 之 后 ) 


public static String renderPageWithSetupsAndTeardowns ( 
PageData pageData, boolean isSuite 
) throws Exception { 
boolean isTestPage = pageData.hasAttribute("Test") ; 
if (isTestPage) { 
_WikiPage testPage - pageData.getWikiPage(); 
StringBuffer newPageContent = new StringBuffer(); 
.  includeSetupPages (testPage, newPageContent, isSuite); 
| newPageContent. append (pageData.getContent () ) ; 
includeTeardownPages(testPage, newPageContent, isSuite); 
pageData.setContent (newPageContent.toString()); 
) 
return pageData.getHtml();, 
) 


除非 你 正在 研究 FitNesse， 否 则 就 理解 不 了 所 有 细节 。 不 过 ， 你 大 概 能 明白 ， 该 函数 包 
含 把 一 些 设置 和 拆 解 页 放 入 一 个 测试 页 面 ， 再 泻 染 为 HTML 的 操作 。 如 果 你 熟悉 JUnit, BE 
许 会 想到 ， 该 函数 归属 于 某 个 基于 Web 的 测试 框架 。 而 且 ， 这 当然 没 错 。 从 代码 清单 3-2 中 
获得 信息 很 容易 ， 而 代码 清单 3-1 RUSSE EAH 

是 什么 让 代码 清单 3-2 易于 阅读 和 理解 ? 怎么 才能 让 函数 表达 其 意图 ? 该 给 函数 赋予 哪 








| BE: 一 种 开源 Java 单元 测试 工具 。 见 http:/wwwjunit.org。 
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些 属性 ， 好 让 读者 一 看 就 明白 函数 是 属于 怎样 的 程序 ? 


3.1 短小 


函数 的 第 一 规则 是 要 短小 。 第 二 条 规则 是 还 要 更 短小 。 我 无 法 证 明 这 个 断言 。 我 给 不 出 
任何 证 实 了 小 函数 更 好 的 研究 结果 。 我 能 说 的 是 ， 近 40 年 来 ， 我 写 过 各 种 不 同 大 小 的 函数 。 
BUNT ATIS 3000 行 的 厌 物 ， 也 写 过 许多 100 行 到 300 行 的 函数 ， 我 还 写 过 20 47 
到 30 行 的 。 经 过 漫长 的 试 错 ， 经 验 告诉 我 ， 函 数 就 该 小 。 

在 20 世纪 80 年 代 ， 我 们 常 说 函数 不 该 长 于 一 屏 。 当 然 ， 说 这 话 的 时 候 ，VT100 屏幕 只 
有 24 行 、80 列 ， 而 编辑 器 就 得 先 占 去 4 行 空间 放 菜单 。 如 今 ， 用 上 了 精致 的 字体 和 宽大 的 

显示 器 ， 一 屏 里 面 可 以 显示 100 行 ， 每 行 能 容纳 150 个 字符 。 每 行 都 不 应 该 有 150 ER 
么 长 。 函 数 也 不 该 有 100 行 那么 长 ，20 行 封 顶 最 佳 。 

函数 到 底 该 有 多 长 ? 1991 Æ, RE Kent Beck 位 于 奥 勒 冈 州 (Oregon) 的 家 中 拜访 。 我 
们 坐 到 一 起 写 了 些 代 码 。 他 给 我 看 一 个 叫做 Sparkle KEN) 的 有 趣 的 Java/Swing 小 程序 。 
程序 在 屏幕 上 描画 电影 Cinderella (《 灰 姑娘 》) 中 仙女 用 魔 棒 造 出 的 那 种 视觉 效果 。 只 要 移动 
鼠标 ， 光 标 所 在 处 就 会 爆发 出 一 团 令 人 欣喜 的 火花 ， 沿 着 模拟 重力 场 划 落 到 窗口 底部 。 肯 特 
给 我 看 代码 的 时 候 ， 我 惊讶 于 其 中 那些 函数 尺寸 之 小 。 我 看 惯 了 Swing 程序 中 长 度数 以 里 计 
的 函数 。 但 这 个 程序 中 每 个 函数 都 只 有 两 行 、 三 行 或 四 行 长 。 每 个 函数 都 一 目 了 然 。 每 个 函 
数 都 只 说 一 件 事 。 而 且 ， 每 个 函数 都 依 序 把 你 带 到 下 一 个 函数 。 这 就 是 函数 应 该 达到 的 短小 
程度 ! 

函数 应 该 有 多 短小 ?通常 来 说 ， 应 该 短 于 代码 清单 3-2 中 的 函数 ! 代码 清单 3-2 实在 应 
该 缩短 成 代码 清单 3-3 这 个 样子 。 


代码 清单 3-3 HtmlUtil.java 〈 再 次 重 构 之 后 ) 


public static String renderPageWithSetupsAndTeardowns ( 
PageData pageData, boolean isSuite) throws PKCERETON { 
if (isTestPage (pageData)) 
includeSetupAndTeardownPages (pageData, isSuite); 
return pageData.getHtml(); 


代码 块 和 缩 进 


站 语句 、else 语句 、while 语句 等 ， 其 中 的 代码 块 应 该 只 有 一 行 。 该 行 大 抵 应 该 是 一 个 函 
数 调用 语句 。 这 样 不 但 能 保持 函数 短小 ， 而 且 ， 因 为 块 内 调用 的 函数 拥有 较 具 说 明 性 的 名 称 ， 


” 原 注 ， 我 问 肯 特 是 否 还 保留 这 段 程序 ， 他 说 找 不 到 了 。 我 搜 遍 自己 的 电脑 也 没 找到 。 现 在 只 有 在 记忆 中 有 这 段 程序 了 。 
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从 而 增加 了 文档 上 的 价值 。 
这 也 意味 着 函数 不 应 该 大 到 足以 容纳 局 套 结构 。 所 以 ， 函 数 的 缩 进 层 级 不 该 多 于 一 层 或 
两 层 。 当 然 ， 这 样 的 函数 易于 阅读 和 理解 。 


3.2 只 做 一 件 事 


代码 清单 3-1 显然 想 做 好 几 件 事 。 它 创建 缓冲 区 、 获 取 页 面 、 
搜索 继承 下 来 的 页 面 、 演 染 路 径 、 添 加 神秘 的 字符 串 、 生 成 HTML， 
如 此 等 等 。 代 码 清单 3-1 手忙脚乱 。 而 代码 清单 3-3 则 只 做 一 件 简 
单 的 事 。 它 将 设置 和 拆 解 包 纳 到 测试 页 面 中 。 
过 去 30 年 以 来 ， 以 下 建议 以 不 同形 式 一 再 出 现 : 
函数 应 该 做 一 件 事 。 做 好 这 件 事 。 只 做 这 一 件 事 。 
问题 在 于 很 难 知 道 那 件 该 做 的 事 是 什么 。 代 码 清单 3-3 只 做 了 
一 件 事 ， 对 吧 ? 其 实 也 很 容易 看 作 是 三 件 事 : 
(1) 判断 是 否 为 测试 页 面 ; 
(2) 如 果 是 ， 则 容纳 进 设置 和 分 拆 步 又 ; 
(3) dX HTML. 
— 那 件 事 是 什么 ? 函数 是 做 了 一 件 事 呢 ， 还 是 做 了 三 件 事 ? 注意 ， 这 三 个 步骤 均 在 该 函数 
名 下 的 同一 抽象 屋 上 。 可 以 用 简洁 的 TO 起 头 段落 来 描述 这 个 函数 : 
TO RenderPageWithSetupsAndTeardowns, we check to see whether the page is a test page and 





if so, we include the setups and teardowns. In either case we render the page in HTML. 

(Æ RenderPageWithSetupsAndTeardowns , AE R DREAMER, AS Salag HE 
BLEREPDGGR. AREMARK, Aiè Rk HTML ) 
如果 函数 只 是 做 了 该 函数 名 下 同一 抽象 层 上 的 步骤 ， 则 函数 还 是 只 做 了 一 件 事 。 编 写 函 
数 毕竟 是 为 了 把 大 一 些 的 概念 〈 换 言 之 ， 函 数 的 名 称 ) 拆 分 为 另 一 抽象 层 上 的 一 系列 步骤 。 

代码 清单 3-1 明显 包括 了 处 于 多 个 不 同 抽象 层级 的 步骤 。 显 然 ， 它 所 做 的 不 止 一 件 事 。 
即便 是 代码 清单 3-2 也 有 两 个 抽象 层 ， 这 已 被 我 们 将 其 缩短 的 能 力 所 证 明 。 然 而 ， 很 难 再 将 
代码 清单 3-3 做 有 意义 的 缩短 。 可 以 将 证 语句 拆 出 来 做 一 个 名 为 includeSetupAndTeardonws 
IfTestpage 的 函数 ， 但 那 只 是 重新 诠释 代码 ， 并 未 改变 抽象 层级 。 

所 以 ， 要 判断 函数 是 否 不 止 做 了 一 件 事 ， 还 有 一 个 方法 ， 就 是 看 是 否 能 再 拆 出 一 个 函数 ， 

该 函数 不 仅 只 是 单纯 地 重新 诠释 其 实现 [G34]。 | 


! Bii: LOGO 语言 中 的 TO 关键 字 ， 与 Ruby 和 Python 中 def 关键 字 的 用 法 一 致 。 所 以 ， 每 个 函数 都 以 TO 起 头 。 这 对 
函数 的 设计 产生 了 有 趣 的 影响 。 
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PARP HY Be 


请 看 代码 清单 4-7。 注 意 , generatePrimes 函数 被 切 分 为 declarations. initializations 和 sieve 
等 区 段 。 这 就 是 函数 做 事 太 多 的 明显 征兆 。 只 做 一 件 事 的 函数 无 法 被 合理 地 切 分 为 多 个 区 段 。 


3.3 Sen ARE 


要 确保 函数 只 做 一 件 事 ， 函 数 中 的 语句 都 要 在 同一 抽象 层级 上 。 一 眼 就 能 看 出 ， 代 码 清 
单 3-1 违反 了 这 条 规矩 。 那 里 面 有 getHtml( ) 等 位 于 较 高 抽象 层 的 概念 ， 也 有 String 
pagePathName = PathParser.render(pagePath) 等 位 于 中 间 抽 象 层 的 概念 ， 还 有 .append("\n") 等 位 
于 相当 低 的 抽象 层 的 概念 。 

函数 中 混杂 不 同 抽象 层级 ， 往 往 让 人 迷惑 。 读 者 可 能 无 法 判断 某 个 表达 式 是 基础 概念 还 
是 细节 。 更 恶劣 的 是 ， 就 像 破损 的 窗户 ， 一 旦 细节 与 基础 概念 混杂 ， 更 多 的 细节 就 会 在 函数 


中 纠结 起 来 。 


BME PRERE: 加 下 规则 


我 们 想 要 让 代码 拥有 自 顶 向 下 的 阅读 顺序 。 我 们 想 要 让 每 个 函数 后 面 都 跟着 位 于 下 _- TH 
象 层 级 的 函数 ， 这 样 一 来 ， 在 查看 函数 列表 时 ， 就 能 俩 抽象 层级 问 下 阅读 了 。 我 把 这 叫做 向 
下 规则 。 

换 一 种 说 法 。 我 们 想 要 这 样 读 程序 ， 程序 就 像 是 一 系列 TO 起 头 的 段落 ， 每 一 段 都 描述 
当前 抽象 层级 ， 并 引用 位 于 下 一 抽象 层级 的 后 续 TO 起 头 段 落 。 

To include the setups and teardowns, we include setups, then we include the test page content, 
and then we include the teardowns. (ZS ZZ Ee NIE BR, AABARE Sé wë > REBAR 
AGAR, FHADHER. ) 

To include the setups, we include the suite setup if this is a suite, then we include the oum 
setup. (REMREGR, ORREN, AHALAKEGR, IUEMALIESE XE ERE, 

To include the suite setup, we search the parent hierarchy for the "SuiteSetUp" page and add 
an include statement with the path of that page. ( E 44481 3€ E VK, ARF SuiteSetUp” H 
BH LAAR Z, ER Se ) 

To search the parent... (HRR... nd i 

程序 员 往往 很 难 学 会 遵循 这 条 规则 x 停留 于 一 个 抽象 层级 上 的 函数 。 尽 管 如 此 ， 
学 习 这 个 技巧 还 是 很 重要 。 这 是 保持 函数 短小 、 确 保 只 做 一 件 事 的 要 诀 。 让 代码 读 起 来 像 是 


' 原 注 ，[KP78]。 
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一 系列 目 顶 向 下 的 TO 起 头 段落 是 保持 抽象 层级 协调 一 致 的 有 效 技巧 。 | 
看 看 本 章 末尾 的 代码 清单 3-7。 它 展示 了 遵循 这 条 原则 重 构 的 完整 testableHtml 函数 。 留 
意 每 个 函数 是 如 何 引 出 下 一 个 函数 ， 如 何 保持 在 同一 抽象 层 上 的 。 


3.4 switch 语句 


写 出 短小 的 switch 语句 很 难 !。 即 便 是 只 有 两 种 条 件 的 switch 语句 也 要 比 我 想 要 的 单个 
代码 块 或 函数 大 得 多 。 写 出 只 做 一 件 事 的 switch 语句 也 很 难 。Switch 天 生 要 做 N 件 事 。 不 幸 
我 们 总 无 法 避 开 switch 语句 ， 不 过 还 是 能 够 确保 每 个 switch 都 埋藏 在 较 低 的 抽象 层级 ， 而 且 
永远 不 重复 。 当 然 ， 我 们 利用 多 态 来 实现 这 一 后 。 

请 看 代码 清单 3-4。 它 呈现 了 可 能 依赖 于 雇员 类 型 的 仅仅 一 种 操作 。 


”代码 清单 3-4 Payrolljava 


public Money calculatePay(Employee e) 
throws InvalidEmployeeType { 
switch (e.type) { 
case COMMISSIONED: 
return calculateCommissionedPay (e); 
case HOURLY: 
return calculateHourlyPay (e); 
case SALARIED: | 
return calculateSalariedPay (e); 
default: 
throw new InvalidEmployeeType (e.type); 
) 
) 


该 函数 有 好 几 个 问题 。 首 先 ， 它 太 长 ， 当 出 现 新 的 雇员 类 型 时 ， 还 会 变 得 更 长 。 其 次 ， 
它 明 显 做 了 不 止 一 件 事 。 第 三 , 它 违反 了 单一 权 责 原则 (Single Responsibility Principle’, SRP), 
因为 有 好 几 个 修改 它 的 理由 。 第 四 ， 它 违反 了 开放 闭合 原则 (Open Closed Principle’, OCP), 
因为 每 当 添 加 新 类 型 时 ， 就 必须 修改 之 。 不 过 ， 该 函数 最 麻烦 的 可 能 是 到 处 此 有 类 似 结构 的 
函数 。 例 如 ， 可 能 会 有 

isPayday (Employee e, Date date), 

或 

deliverPay (Employee e, Money pay), 
Em, SAM, RBE iffelse 语句 在 内 。 
? BE: a. http://en.wikipedia.org/wiki/Single responsibility principle; 
b. http://www.objectmentor.com/resources/articles/srp.pdf. 


> RE: a. http;//en.wikipedia.org/wiki/Open/closed principle; 
b. http://www.objectmentor.com/resources/articles/ocp.pdf. 
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如 此 等 等 。 它 们 的 结构 都 有 同样 的 问题 。 

该 问题 的 解决 方案 (如 代码 清单 3-5 所 示 ) 是 将 switch ESI 底下 , 不 让 任 
何人 看 到 。 该 工厂 使 用 switch 语句 为 Employee 的 派生 物 创 建 这 当 的 实体 ， 而 不 同 的 函数 ， 
如 calculatePay、isPayday 和 deliverPay F, NZH Employee 接口 多 态 地 接受 派 遗 。 

对 于 switch 语句 ， 我 的 规矩 是 如 果 只 出 现 一 次 ， 用 于 创建 多 态 对 象 ， 而 且 隐 藏 在 某 个 继 
承 关系 中 ， 在 系统 其 他 部 分 看 不 到 ， 就 还 能 容忍 [G23]。 当 然 也 要 就 事 论 事 ， 有 时 我 也 会 部 分 
或 全 部 违反 这 条 规矩 。 


代码 清单 3-5 Employee 与 工厂 


public abstract class Employee { 
public abstract boolean isPayday(); 
public abstract Money calculatePay(); 
public abstract void deliverPay (Money pay); 


public interface EmployeeFactory { 
public Employee makeEmployee (EmployeeRecord r) throws InvalidEmployeeType; 


public class EmployeeFactoryImpl implements EmployeeFactory { 
public Employee makeEmployee(EmployeeRecord r) throws InvalidEmployeeType { 
Switch (r.type) { 
case COMMISSIONED: 
return new CommissionedEmployee(r) ; 
case HOURLY: 
return new HourlyEmployee (r); 
case SALARIED: P 
return new SalariedEmploye(r); 
default: 
throw new InvalidEmployeeType (r.type); 
) 
) 
) , 
} 


3.5 ”使 用 描述 性 的 名 称 


在 代码 清单 3-7 中 ,我 把 示例 函数 的 名 称 从 testableHtml 改 为 SetupTeardownIncluder.render。 
这 个 名 称 好 得 多 ， 因 为 它 较 好 地 描述 了 函数 做 的 事 。 我 也 给 每 个 私有 方法 取 个 同样 具有 描述 性 
的 名 称 ， 如 isTestable 或 includeSetupAndTeardownPages。 好 名 称 的 价值 怎么 好 评 都 不 为 过 。 
记 住 沃 德 原则 : “如果 每 个 例 程 都 让 你 感到 深 合 己 意 ， 那 就 是 整洁 代码 .” 要 遵循 这 一 原则 ， 


' 原 注 : [GOF]。 
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泰 半 工作 都 在 于 为 只 做 一 件 事 的 小 函数 取 个 好 名 字 。 函 数 越 短小 、 功 能 越 集中 ， 就 越 便于 取 
个 好 名 字 。 
别 害怕 长 名 称 。 长 而 具有 描述 性 的 名 称 ， 要 比 短 而 令 人 费解 的 名 称 好 。 长 而 具有 描述 性 
的 名 称 ， 要 比 描述 性 的 长 注释 好 。 使 用 某 种 命名 约定 ， 让 函数 名 称 中 的 多 个 单词 容易 阅读 ， 
然后 使 用 这 些 单词 给 函数 取 个 能 说 清 其 功用 的 名 称 。 
别 害怕 花 时 间 取 名 字 。 你 当 尝 试 不 同 的 名 称 ， 实测 其 阅读 效果 。 在 Eclipse 或 IntelliJ 等 
现代 IDE 中 改名 称 易如反掌 。 使 用 这 些 IDE 测试 不 同名 称 / 直至 找到 最 具有 描述 性 的 那 一 个 
为 止 。 
选择 描述 性 的 名 称 能 理 清 你 关于 模块 的 设计 思路 ， 并 帮 你 改进 之 。 Bd Au 往往 导 
致 对 代码 的 改善 重 构 。 
”命名 方式 要 保持 一 至。 使 用 与 模块 名 一 脉 相 承 的 短语 、 名 词 和 动词 给 函数 命名 。 例 如 ， 
includeSetupAndTeardownPages、includeSetupPages includeSuiteSetupPage 和 includeSetupPage 
等 。 这 些 名 称 使 用 了 类 似 的 措辞 ， 依 序 讲 出 一 个 故事 。 实 际 上 ， 假 使 我 只 给 你 看 上 述 函 数 序 
” 列 , 你 就 会 自问 :“includeTeardownPages、includeSuiteTeardownPages 和 includeTeardownPage 
”又 会 如 何 ? ”这 就 是 所 谓 “ 深 合 己 意 ” 了 
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” “最 理想 的 参数 数量 是 零 ( 零 参数 函数 )， 其 次 是 一 ( 单 
”参数 函数 )， 再 次 是 二 〔 双 参数 函数 )， 应 尽量 避免 三 (三 
:参数 函数 )。 有 足够 特殊 的 理由 才能 用 三 个 以 上 参数 〈 多 参 
-ARRO 一 一 所 以 无 论 如 何 也 不 要 这 么 做 。 

E BRR AIT. ETERNA RES EE. ATES ml 
中 几乎 不 加 参数 。 比 如 ， 以 StringBuffer 为 例 , 我 们 可 能 不 把 它 
作为 实体 变量 ， 而 是 当 作 参数 来 传递 ， 那 样 的 话 ， 读 者 每 次 看 di SEES 
.到 它 都 得 要 翻译 一 遍 。 阅 读 模块 所 讲述 的 故事 时 ， PV UK 
iicludeSetupPage( JE includeSetupPagelnto(newPage-Content) — S Ki? e 
易于 理解 。 参 数 与 函数 名 处 在 不 同 的 抽象 层级 ， 它 要 求 你 了 解 
四 前 并 不 特别 重要 的 细节 〈 即 那个 StringBuffer). AA 
”从 测试 的 角度 看 ， 参 数 甚至 更 叫 人 为 难 。 想 想 看 ,要 “ 

j 写 能 确保 参数 的 各 种 组 合 运行 正常 的 测试 用 例 ， 是 多 么 困难 的 事 。 如 果 没 有 参数 ， 就 是 小 
一 碟 。 如 果 只 有 一 个 参数 ， 也 不 太 困 难 。 有 两 个 参数 ， 问 题 就 麻烦 多 了 。 如 果 参 数 多 于 两 
”测试 覆盖 所 有 可 能 值 的 组 合 简直 让 人 生 蔷 。 

输出 参数 比 输入 参数 还 要 难以 理解 。 读 函数 时 ， 我 们 惯 于 认为 信息 通过 参数 输入 函数 ， 
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通过 返回 值 从 函数 中 输出 。 我 们 不 太 期 望 信息 通过 参数 输出 。 所 以 ， 输 出 ee Scie 
ZIGA PRK. | | 

相 较 于 没有 参数 ， 只 有 一 个 输入 参数 算是 第 二 好 的 做 法 。SetupTeardownInclude.render 
(pageData》 也 相当 易于 理解 。 很 明显 ， 我 们 将 泻 染 pageData WHR PHAGE. | 


3.6.1 一 元 峭 数 的 普遍 形式 


向 函数 传 入 单个 参数 有 两 种 极 普遍 的 理由 。 你 也 许 会 问 关 于 那个 参数 的 问题 ， 就 像 在 
boolean fileExists("MyFile") 中 那样 。 也 可 能 是 操作 该 参数 ， 将 其 转换 为 其 他 什么 东西 ， 再 输 
出 之 。 Sin, InputStream fileOpen("MyFile") 把 String 类 型 的 文件 名 转换 为 InputStream 类 型 的 
返回 值 。 这 就 是 读者 看 到 函数 时 所 期 待 的 东西 。 你 应 当选 用 较 能 区 别 这 两 种 理由 的 名 称 ， 而 
且 总 在 一 致 的 上 下 文中 使 用 这 两 种 形式 。 

还 有 一 种 虽 不 那么 普遍 但 仍 极 有 用 的 单 参数 函数 形式 ， 那 就 是 事件 〈event)。 在 这 种 形 
式 中 ， 有 输入 参数 而 无 输出 参数 。 程 序 将 函数 看 作 是 一 个 事件 ， 使 用 该 参数 修改 系统 状态 ， 
例如 void passwordAttemptFailedNtimes(int attempts)。 小 心 使 用 这 种 形式 。 应 该 让 读者 很 清楚 
地 了 解 它 是 个 事件 。 谨 慎 地 选用 名 称 和 上 下 文 语 境 。 

尽量 避免 编写 不 遵循 这 些 形式 的 一 元 函数 ， 例 如 ，void includeSetupPageInto(StringBuffer 
pageText)。 对 于 转换 ， 使 用 输出 参数 而 非 返 回 值 令 人 迷惑 。 如 果 函 数 要 对 输入 参数 进行 转换 
操作 ， 转 换 结果 就 该 体现 为 返回 值 。 实 际 上 ，StringBuffer transform(StringBuffer in) 要 比 void 
transform(StringBuffer out) 强 ， 即 便 第 一 种 形式 只 简单 地 返回 输 参数 也 是 这 样 。 至 少 ， 它 遵循 
了 转换 的 形式 。 
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标识 参数 丑陋 不 堪 。 向 函数 传 入 布尔 值 简 直 就 是 骇人听闻 的 做 法 。 这 样 做 ， 方 法 签名 立 
刻 变 得 复杂 起 来 ， 大 声 宣布 本 函数 不 止 做 一 件 事 。 如 果 标 识 为 true 将 会 这 样 做 ， y 只 为 false 
则 会 那样 做 ! 

在 代码 清单 3-7 中 ， 我 们 别 无 选择 ， 因 为 调用 者 已 经 传 入 了 那个 标识 ， 而 我 想 把 重 构 范 
围 限制 在 该 函数 及 该 函数 以 下 范围 之 内 。 方 法 调用 render(true) 对 于 可 怜 的 读者 来 说 仍然 摸 不 
着 头脑 。 卷 动 屏 幕 ， 看 到 render(Boolean isSuite)， 稍 许 有 点 帮助 ， 不 够 。 应 该 把 该 
函数 一 分 为 二 : reanderForSuite( ) 和 renderForSingleTest( )。 


36.3 JCM 


有 两 个 参数 的 函数 要 比 一 元 函数 难 懂 。 例 如 ，writeField(name) 比 writeField(outputStream, 
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name) BR. | 

尽管 两 种 情况 下 意义 都 很 清楚 ， 但 第 一 个 只 要 扫 一 眼 就 明白 ， 更 好 地 表达 了 其 意义 。 第 
二 个 就 得 暂停 一 下 才能 明白 ， 除 非 我 们 学 会 忽略 第 一 个 参数 。 而 且 最 终 那 也 会 导致 问题 ， 因 
为 我 们 根本 就 不 该 忽略 任何 代码 。 忽 略 掉 的 部 分 束 是 缺陷 藏身 之 地 。 

当然 ， 有 些 时 候 两 个 参数 正好 。 例 如 ，Point p new Point, 0); 就 相当 合理 。 HELAK 
生 拥 有 两 个 参数 。 如 果 看 到 new Point(0)， 我们 会 倍 感 惊讶 。 然 而 ， 本 例 中 的 两 个 参数 却 只 是 
”单个 值 的 有 序 组 成 部 分 ! 而 output-Stream 和 name 则 既 非 自然 的 组 合 ， 也 不 是 自然 的 排序 。 

即便 是 如 assertEquals(expected，actual) 这 样 的 二 元 函数 也 有 其 问题 。 你 有 多 少 次 会 搞 错 
actual 和 expected WAER? 这 两 个 参数 没有 目 然 的 顺序 。 E 在 前 ，actual 在 后 ， 只 是 
一 种 需要 学 习 的 约定 罢了 。 — 

二 元 函数 不 算 恶 劣 ， 而 且 你 当然 也 会 编写 二 元 函数 。 不 过 ， 你 得 小 心 ， 使 用 二 元 函数 要 
付出 代价 。 你 应 该 尽量 利用 一 些 机 制 将 其 转换 成 一 元 函数 。 例 如 ， 可 以 把 writeField 方法 写 
成 outputStream 的 成 员 之 一 ;从 而 能 这 样 用 outputStream.writeField(name)。 或 者 ， 也 可 以 把 
outputStream 写成 当前 类 的 成 员 变 量 ， 从 而 无 需 再 传递 它 。 还 可 以 分 离 出 类 似 FieldWriter 的 
新 类 ， 在 其 构造 器 中 采用 outputStream， 并 且 包 含 一 个 write WE. 


35.4 三 元 函数 


有 三 个 参数 的 函数 要 比 二 元 函数 难 懂 得 多 。 排 序 、 琢 磨 、 忽 略 的 问题 都 会 加 倍 体现 。 建 
议 你 在 写 三 元 函数 前 一 定 要 想 清楚 。 

例如 ， 设 想 assertEquals 有 三 个 参数 : assertEquals(message， apei actual). AZ Dik, 
你 读 到 — 错 以 为 它 是 expected UE? 我 束 常 栽 在 这 个 三 元 函数 上 。 实 际 上 ， 每 次 我 看 
到 这 里 ， 总 会 绕 半 天 圈子 ， 最 后 学 会 了 忽略 message 参数 。 

A ën 这 里 有 个 并 不 那么 险恶 的 三 元 函数 : assertEquals(1.0, amount, .001). BAR 
要 费 点 神 ， 还 是 值得 的 。 得 到 “ 浮 点 值 的 等 值 是 相对 而 言 ” 的 提示 总 是 好 的 。 
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。 如 果 函数 看 来 需要 两 个 、 三 个 或 三 个 以 上 参数 ， 就 说 明 其 中 一 些 参数 应 该 封装 为 类 了 。 
例如 ， 下 面 两 个 声明 的 差别 ; 


Circle makeCircle(double x, double y, double radius); 
Circle makeCircle(Point center, double radius); 


—O 原 注 :我 刚 重 构 了 一 个 使 用 了 二 元 形式 的 模块 。 现 在 就 能 把 outputStream 做 成 该 类 的 一 个 字段 ， 并 把 所 有 对 writeField 
的 调用 都 变 作 一 元 形式 。 结 果 就 干净 多 了 。 
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从 参数 创建 对 象 ， 从 而 减少 参数 数量 ， 看 起 来 像 是 在 作 浆 ， 但 实则 并 非 如 此 。 当 一 组 参 
数 被 共同 传递 ， 就 像 上 例 中 的 x 和 y 那样 ， 往 往 就 是 该 有 自己 名 称 的 某 个 概念 的 一 部 分 。 


356556 ”参数 列表 
有 时 ， 我 们 想 要 疝 函 数 传 入 数量 可 变 的 参数 。 例 如 ，String.format 方法 : 


String.format("$s worked %.2f hours.", name, hours); 


如 果 可 变 参 数 像 上 例 中 那样 被 同等 对 待 ， 就 和 类 型 为 List 的 单个 参数 没什么 两 样 。 这 样 
一 来 ，String.formate 实则 是 二 元 函数 。 下 列 String.format 的 声 le 元 的 : 


public String format (String format, Object.. . args) 
同 理 ， 有 可 变 参 数 的 函数 可 能 是 一 元 、 二 元 其 至 三 元 。 超 过 这 个 数量 就 可 能 要 犯错 了 。 


void monad (Integer... args); 
void dyad(String name, Integer... args); 
void triad(String name, int count, Integer... args); 


36.7 ”动词 与 关键 字 


给 函数 取 个 好 名 字 ， 能 较 好 地 解释 函数 的 意图 ， 以 及 参数 的 顺序 和 意图 。 对 于 一 元 函数 ， 
国 数 和 参数 应 当 形 成 一 种 非常 良好 的 动词 /名 词 对 形式 。 例 如 ，write(name) 就 相当 令 人 认同 。 
不 管 这 个 “name” 是 什么 ， 都 要 被 “write”。 更 好 的 名 称 大 概 是 writeFieldCname)， 它 告诉 我 
们 ,“name” 是 一 个 “field”。 | 

”最 后 那个 例子 展示 了 函数 名 称 的 关键 字 (keyword) 形式 。 使 用 这 种 形式 ， 我 们 把 参数 的 
名 称 编码 成 了 函数 名 。 例 如 ，assertEqual 改 成 assertExpectedEqualsActual(expected，actual) 可 
会 好 些 。 这 大 大 减轻 了 记忆 参数 顺序 的 负担 。 


3.7 无 副作用 


副作用 是 一 种 谎言 。 函 数 承 诺 只 做 一 件 事 ， 但 还 是 会 做 其 他 被 藏 起 来 的 事 。 有 时， 它 会 
对 自己 类 中 的 变量 做 出 未 能 预期 的 改动 。 有 时 ， 它 会 把 变量 搞 成 同 函数 传递 的 参数 或 是 系统 
全 局 变量 。 无 论 哪 种 情况 ， 都 是 具有 破坏 性 的 ， 会 导致 古怪 的 时 序 性 耦合 及 顺序 依赖 。 

以 代码 清单 3-6 中 看 似 无 伤 大 雅 的 函数 为 例 。 该 函数 使 用 标准 算法 来 匹配 userName 和 
password。 如 果 匹 配 成 功 ， 返 回 true， 如 果 失 败 则 返回 false。 但 它 会 有 副作用 。 你 知道 问题 
所 在 吗 ? 
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代码 清单 3-6 UserValidator.java 


public class UserValidator { 
private Cryptographer cryptographer; 


public boolean checkPassword(String userName, String password) { 
User user - UserGateway.findByName (userName); 
if (user != User.NULL) { 
String codedPhrase - user.getPhraseEncodedByPassword(); 
String phrase = cryptographer.decrypt(codedPhrase, password); 
if ("Valid Password".equals(phrase)) ( 
Session.initialize(); 
return true; 
) 
) 
return false; 


) 
} 

当然 了 ， 副 作用 就 在 于 对 Session.initialize() 的 调用 。checkPassword 函数 ， 顾 名 思 义 ， 就 
是 用 来 检查 密码 的 。 该 名 称 并 未 暗示 它 会 初始 化 该 次 会 话 。 所 以 ， 当 某 个 误 信 了 函数 名 的 调 
用 者 想 要 检查 用 户 有 效 性 时 ， 就 得 冒 抹 除 现 有 会 话 数据 的 风险 。 | 

这 一 副作用 造 出 了 一 次 时 序 性 耦合 。 也 就 是 说 ，checkPassword 只 能 在 特定 时 刻 调用 CHR 
言 之 ， 在 初始 化 会 话 是 安全 的 时 候 调 用 )。 如 果 在 不 合适 的 时 候 调 用 , 会 话 数 据 就 有 可 能 沉默 
地 丢失 。 时 序 性 耦合 令 人 迷惑 ， 特 别 是 当 它 躲 在 副作用 后 面 时 。 如 果 一 定 要 时 序 性 耦合 ， 就 
应 该 在 函数 名 称 中 说 明 。 在 本 例 中 ， 可 以 重 命名 函数 为 checkPasswordAndInitializeSession， 
虽然 那 还 是 违反 了 “只 做 一 件 事 ” 的 规则 。 


输出 参数 

参数 多 数 会 被 自然 而 然 地 看 作 是 函数 的 输入 。 如 果 你 编 过 好 些 年 程序 ， 我 担保 你 一 定 被 
用 作答 出 而 非 输入 的 参数 迷惑 过 。 例 如 

DEER 

这 个 函数 是 把 s 添 加 到 什么 东西 后 面 吗 ? 或 者 它 把 什么 东西 添加 到 了 s 后 面 ? s 是 输入 参 
数 还 是 输出 参数 ? 稍 许 花 点 时 间 看 看 函数 签名 : 

public void appendFooter (StringBuffer report) 

事情 清楚 了 ,但 付出 了 检查 函数 声明 的 代价 。 你 被 迫 检 查 函 数 签 名 ， 就 得 花 上 一 点 时 间 。 
应 该 避免 这 种 中 断 思 路 的 事 。 

在 面向 对 象 编程 之 前 的 岁月 里 ， 有 时 的 确 需 要 输出 参数 。 然 而 ， 面 向 对 象 语言 中 对 输出 
参数 的 大 部 分 需求 已 经 消失 了 ， 因为 this 也 有 输出 函数 的 意味 在 内 。 换 言 之 ， 最 好 是 这 样 调 
用 appendFooter: 


report.appendFooter () ; 
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普遍 而 言 , 应 避免 使 用 输出 参数 。 如 果 函 数 必须 要 修改 某 种 状态 , 就 修改 所 属 对 象 的 状态 吧 。 


3.8 分隔 指令 与 询问 


BUREAU AG. 要 么 回答 什么 事 ， 但 二 者 不 可 得 兼 。 函 数 应 该 修改 某 对 象 的 状态 ， 
或 是 返回 该 对 象 的 有 关 信 息 。 两 样 都 干 常 会 导致 混乱 。 看 看 下 面 的 例子 : 


public boolean set(String attribute, String value); 


该 函数 设置 某 个 指定 属性 ， 如 果 成 功 就 返回 true, MRA 存在 那个 属性 则 返回 false. 3X 
样 就 导致 了 以 下 语句 : 


. if (set("username", "unclebob")).. 

从 读者 的 角度 考虑 一 下 吧 。 这 是 什么 意思 呢 ? 它 是 在 问 username 属性 值 是 否 之 前 已 设置 
为 unclebob 吗 ? 或 者 它 是 在 问 username 属性 值 是 否 成 功 设置 为 unclebob W? 从 这 行 调 用 很 
难 判 断 其 含义 ， 因 为 set 是 动词 还 是 形容 词 并 不 清楚 。 

作者 本 意 ，set 是 个 动词 ,但 在 让 语句 的 上 下 文中 ， 感 觉 它 像 是 个 形容 词 。 该 语句 读 起 来 
像 是 说 “如 果 username 属性 值 之 前 已 被 设置 为 uncleob ”， 而 不 是 “设置 username 属性 值 为 
unclebob， 看 看 是 否 可 行 ， 然 后 …… ^. 要 解决 这 个 问题 ， 可 以 将 set 函数 重 命名 为 
setAndCheckIfExists， 但 这 对 提高 if 语句 的 可 读 性 帮助 不 大 。 真 正 的 解决 方案 是 把 指令 与 询 
问 分 隔 开 来 ， 防 止 混淆 的 发 生 : 


if (attributeExists ("username")) { 
setAttribute("username", "unclebob"); 


) 


3.9 ”使 用 异常 替代 返回 错误 码 


从 指令 式 函 数 返 回 错误 码 轻微 违反 了 指令 与 询问 分 隔 的 规则 。 它 鼓励 了 在 计 语 句 判断 中 
把 指令 当 作 表达 式 使 用 。 

if (deletePage (page) == E_OK) 

这 不 会 引起 动词 /形容 词 混淆 ， 但 却 导致 更 深 REREN 当 返回 错误 码 时 ， 就 是 在 
要 求 调 用 者 立刻 处 理 错误 。 


if (deletePage(page) == E OK) { 
if (registry.deleteReference(page.name) -- E OK) { 
if (configKeys.deleteKey (page.name.makeKey()) == E OK)( 


logger.log("page deleted"); 


39 ”使 用 异常 替代 返回 错误 码 4 


) else { 
logger.log("configKey not deleted"); 

) 
} else { 
logger.log("deleteReference from registry failed"); 
} " 
) else ( 

logger.log("delete failed"); 

return E ERROR; 
) . 


男 一 方面 , 如果 使 用 异常 替代 返回 错误 码 , 错误 处 理 代 码 就 能 从 主 路 径 代 码 中 分 离 出 来 ， 
得 到 简化 : | l | 


try f 
deletePage(page); 
registry.deleteReference (page.name) ; 
configKeys.deleteKey (page.name.makeKey ()) ; 

) 

catch (Exception e) { 
logger.log(e.getMessage()); 

) 


39.1 BE Trycatch 代码 块 


Try/catch 代码 块 丑 随 不 堪 。 它 们 搞 乱 了 代码 结构 ， 把 错误 处 理 与 正常 流程 混为一谈 。 最 
好 把 try 和 catch 代码 块 的 主体 部 分 抽 离 出 来 ， 另 外 形成 函数 。 


public void delete(Page page) ( 
try { 
deletePageAndAllReferences (page); 
) 
catch (Exception e) { 
logError(e); 
` i 
) 


private void deletePageAndAllReferences(Page page) throws Exception { 
deletePage (page); 
registry.deleteReference (page.name); 
configKeys.deleteKey (page.name.makeKey () ) ; 
} | 


private void logError (Exception e) { 
logger.log(e.getMessage()); 
) 


在 上 例 中 , delete 函数 只 与 错误 处 理 有 关 。 很 容易 理解 然后 就 忽略 掉 。deletePageAndAlIReference 
函数 只 与 完全 删除 一 个 page 有 关 。 错 误 处 理 可 以 忽略 掉 。 有 了 这 样 美 妙 的 区 隔 ， 代 码 就 更 易于 理 
解 和 修改 了 。  - CR 7 | | | 
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392 错误 处 理 就 是 一 件 事 


函数 应 该 只 做 一 件 事 。 错 误 处 理 就 是 一 件 事 。 因 此 ， 处 理 错误 的 函数 不 该 做 其 他 事 。 这 
意味 着 (如 上 例 所 示 ) 如 果 关键 字 try 在 某 个 函数 中 存在 ， 它 就 该 是 这 个 函数 的 第 一 个 单词 
而 且 在 catch/finally 代码 块 后 面 也 不 该 有 其 他 内 容 。 | 


393 Error.java 依赖 磁铁 
返回 错误 码 通常 暗示 某 处 有 个 类 或 是 枚 举 ， 定 义 了 所 有 错误 码 。 


public enum Error { 
OK, 
INVALID, 
NO SUCH, 
LOCKED, 
OUT OF RESOURCES, 
WAITING FOR EVENT; 
) 


这 样 的 类 就 是 一 块 依 赖 磁铁 〈dependency magnet); 其 他 许多 类 都 得 导入 和 使 用 它 。 当 
Error 枚 举 修改 时 , 所 有 这 些 其 他 的 类 都 需要 重新 编译 和 部 署 。 这 对 Error 类 造成 了 负面 压力 。 
程序 员 不 愿 增加 新 的 错误 代码 ， 因 为 这 样 他 们 就 得 重新 构建 和 部 署 所 有 东西 。 于 是 他 们 就 复 
用 旧 的 错误 码 ， 而 不 添加 新 的 。 

Umm 种 蔡 代 铬 误 码 ， 新 异常 就 可 以 从 异常 类 派生 出 来 ， 无 需 重新 编译 或 重新 部 署 2。 


310 ane? 


回头 仔细 看 看 代码 清单 3-1， 你 会 注意 到 ， 有 个 算法 在 
SetUp、SuiteSetUp、TearDown 和 SuiteTearDown 中 总 共 被 
重复 了 4 次 。 识 别 重复 不 太 容 易 ， 因 为 这 4 次 重复 与 其 他 
代码 混在 一 起 ， 而 且 也 不 完全 一 样 。 这 样 的 重复 还 是 会 导 
致 问题 ， 因 为 代码 因此 而 爱 肿 ， 且 当 算 法 改变 时 需要 修改 4 
处 地 方 。 而 且 也 会 增加 4 次 放 过 错误 的 可 能 性 。 

使 用 代码 清单 3-7 中 的 include 方法 修正 了 这 些 重 复 。 
再 读 一 遍 那 段 代 码 ， 你 会 注意 到 ， 整 个 模块 的 可 读 性 因为 重复 的 消除 而 得 到 了 提升。 





' 原 注 ， 那 些 以 为 可 以 不 重新 编译 和 部 署 就 扬长 而 去 的 家 伙 最 终 都 自 尝 恶果 。 
"Rat, 这 也 是 开放 闭合 原则 COCP) 的 一 个 范例 [PPP02]。 
.3 原 注 ，DRY NJ. [PRAG]. 
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重复 可 能 是 软件 中 一 切 政 恶 的 根源 ,许多 原则 与 实践 规则 都 是 为 控制 与 消除 重复 而 创建 。 
例如 ， 全 部 考 德 (Codd) 数据 库 范式 都 是 为 消灭 数据 重复 而 服务 。 再 想 想 看 ， 面 向 对 象 编程 
是 如 何 将 代码 集中 到 基 类 ， 从 而 避免 了 宛 余 。 面 向 方面 编程 (Aspect Oriented Programming). 
面向 组 件 编程 《Component Oriented Programming) 多 少 也 都 是 消除 重复 的 一 种 策略 。 看 来 ， 
自 子 程序 发 明 以 来 ， 软 件 开发 领域 的 所 有 创新 都 是 在 不 断 尝试 从 源 代 码 中 消灭 重复 。 


3.11 ”结构 化 编程 


有 些 程序 员 遵循 Edsger Dijkstra 的 结构 化 编程 规则 *。Dijkstra 认为 ， 每 个 函数 、 函 数 中 
的 每 个 代码 块 都 应 该 有 一 个 入 口 、 一 个 出 口 。 遵 循 这 些 规 则 ， 意 味 着 在 每 个 函数 中 只 该 有 一 
个 return 语句 ， 循 环 中 不 能 有 break 或 continue 语句 ， 而 且 永 永远 远 不 能 有 任何 goto 语句 。 

我 们 赞成 结构 化 编程 的 目标 和 规范 ， 但 对 于 小 函数 ， 这 些 规则 助 益 不 大 。 只 有 在 大 函数 
中 ， 这 些 规 则 才 会 有 明显 的 好 处 。 

所 以 ， 只 要 函数 保持 短小 ， 偶 尔 出 现 的 return. break 或 continue 语句 没有 坏处 ， 甚至 还 比 单 
入 单 出 原则 更 具有 表达 力 。 另 外 一 方面 ，goto 只 在 大 函数 中 才 有 道理 ， 所 以 应 该 尽量 避免 使 用 。 


3.12 ”如 何 与 出 这 样 的 函数 


写 代 码 和 写 别 的 东西 很 像 。 在 写 论文 或 文章 时 ， 你 先 想 什么 就 写 什么 ， 然 后 再 打磨 它 。 
Wri, MRE, BEAD APT. 

我 写 函 数 时 ， 一 开始 都 元 长 而 复杂 。 有 太 多 缩 进 和 鼠 套 循环 。 有 过 长 的 参数 列表 。 名 称 
是 随意 取 的 ， 也 会 有 重复 的 代码 。 不 过 我 会 配 上 一 套 单元 测试 ， 覆 盖 每 行 丑陋 的 代码 。 

然后 我 打磨 这 些 代码 ， 分 解 函数 、 修 改名 称 、 消 除 重复 。 我 缩短 和 重新 安置 方法 。 有 了 时 
我 还 拆散 类 。 同 时 保持 测试 通过 。 

最 后 ， 遵 循 本 章 列 出 的 规则 ， 我 组 装 好 这 些 函 数 。 

我 并 不 从 一 开始 就 按照 规则 写 函 数 。 我 想 没 人 做 得 到 。 


3.13 ”小 结 


每 个 系统 都 是 使 用 某 种 领域 特定 语言 搭建 ,而 这 种 语言 是 程序 员 设计 来 描述 那个 系统 的 。 


! 译注 ， 艾 德 加 。F。 考 德 (EdgarF. Codd)， 关 系数 据 库 之 父 。 
” 原 注 ，[SP72]。 
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函数 是 语言 的 动词 ， 类 是 名 词 。 这 并 非 是 退回 到 那 种 认为 需求 文档 中 的 名 词 和 动词 就 是 系统 
中 类 和 函数 的 最 初 设想 的 可 怕 的 旧 观 念 。 其 实 这 是 个 历史 更 久 的 真理 。 DËSE RS 
是 语言 设计 的 艺术 。 

大 师 级 程序 员 把 系统 当 作 故事 来 讲 ， 而 不 是 当 作 程 序 来 写 。 deele 
的 工具 构建 一 种 更 为 丰富 且 更 具 表 达 力 的 语言 ， 用 来 讲 那个 故事 。 那 种 领域 特定 语言 的 一 个 
部 分 ， 就 是 描述 在 系统 中 发 生 的 各 种 行为 的 函数 层级 。 在 一 种 匀 的 递 操 作 中 ， 这 些 行为 
使 用 它们 定义 的 与 领域 紧密 相关 的 语言 讲述 目 己 那个 小 故事 。 

本 章 押 讲述 的 是 有 关 编 号 良好 函数 的 机 制 。 如 果 你 遵循 这 些 规则 ， 函 数 就 会 短小 ， 有 个 
好 名 字 ， 而 且 被 很 好 地 归 置 。 不 过 永远 别 忘 记 ， 真 正 的 目标 在 于 讲述 系统 的 故事 ， 而 你 编写 
的 函数 必须 干净 利落 地 拼装 到 一 起 ， 形 成 一 种 精确 而 清晰 的 语言 ， 帮 助 你 讲 故事 。 


3.14 SetupTeardownlncluder 程序 


代码 清单 3-7 SetupTeardownlncluder.java 
package fitnesse.html; 


import fitnesse.responders.run.SuiteResponder; 
import fitnesse.wiki.*; 


public class SetupTeardownIncluder { 
private PageData pageData; 
private boolean isSuite; 
private WikiPage testPage; 
private StringBuffer newPageContent; 
private PageCrawler pageCrawler; 


public static String render(PageData pageData) throws Exception { 
return render(pageData, false); 


) 


public static String render(PageData pageData, boolean isSuite) 
throws Exception { 
return new SetupTeardownIncluder (pageData).render(isSuite); 

) 

private SetupTeardownIncluder(PageData pageData) { 
this.pageData = pageData; 
testPage = pageData.getWikiPage(); 
pageCrawler = testPage.getPageCrawler(); 
newPageContent = new StringBuffer(); 


} 


private String render(boolean isSuite) throws Exception { 
this.isSuite = isSuite; 
if (isTestPage()) 
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includeSetupAndTeardownPages(); 
return pageData.getHtml (); 
} 


private boolean isTestPage() throws Exception { 
return págeData.hasAttribute ("Test"); 


) 


private void includeSetupAndTeardownPages() throws Exception ( 
includeSetupPages (); 
includePageContent () ; 
includeTeardownPages (); 
updatePageContent (); 
) 


private void includeSetupPages() throws Exception { 
if (isSuite) | 
includeSuiteSetupPage () ; 
includeSetupPage () ; 
} 


private void includeSuiteSetupPage() throws Exception { 
include (SuiteResponder.SUITE_SETUP_NAME, "-setup"); 


} 


private void includeSetupPage() throws Exception { 
include("SetUp", "-setup"); 
} 


private void includePageContent() throws Exception { 
newPageContent.append (pageData.getContent (il: 
} 


private void includeTeardownPages() throws Exception { 
includeTeardownPage(); 
if (isSuite) 
includeSuiteTeardownPage(); 


) / 


private void includeTeardownPage() throws Exception { 
include ("TearDown", "-teardown"); 


) 


private void includeSuiteTeardownPage() throws Exception { 
include(SuiteResponder.SUITE TEARDOWN NAME, "-teardown"); 


) 


private void updatePageContent() throws Exception { 
pageData.setContent (newPageContent.toString()); 
) 


private void include(String pageName, String arg) throws Exception { 
WikiPage inheritedPage - findInheritedPage (pageName); 
if (inheritedPage != null) ( 
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String pagePathName = getPathNameForPage(inheritedPage); 
buildIncludeDirective (pagePathName, arg); 


) 
) 


private WikiPage findInheritedPage(String pageName) throws Exception ( 
return PageCrawlerImpl.getInheritedPage(pageName, testPage); 


) 


private String getPathNameForPage(WikiPage page) throws Exception { 
WikiPagePath pagePath = pageCrawler.getFullPath (page); 
return PathParser.render (pagePath); 


} 


private void buildIncludeDirective(String pagePathName, String arg) { 
newPageContent ) : 
.append("Mn!include ") 
.append (arg) 
.append(" .") 
. append (pagePathName) 
append ("Mn") ; 
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“Fill FB A ANA Ao iE —— FH Bre,” 
—Brian W Kernighan 5 P J. Plaugher! 
什么 也 比 不 上 放置 良好 的 注释 来 得 有 用 。 什 么 也 不 会 比 乱七八糟 的 注释 更 有 本 事 搞 乱 一 
个 模块 。 什 么 也 不 会 比 陈 上 昌 、 提 供销 误 信 息 的 注释 更 有 破坏 性 。 
注释 并 不 像 半 德 勒 的 名 单 。 它 们 并 不 “ 纯 然 地 好 ”。 实 际 上 ， 注 释 最 多 也 就 是 一 种 必 


须 的 恶 。 若 编程 语言 足够 有 表达 力 , 或 者 我 们 长 于 用 这 些 语言 来 表达 意图 ; 就 不 那么 需要 
注释 一 一 也 许 根本 不 需要 。 | 





' JRE: [KP78], p.144. 
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注释 的 恰当 用 法 是 弥补 我 们 在 用 代码 表达 意图 时 遭遇 的 失败 。 注 意 ， 我 用 了 “失败 ”一 
词 。 我 是 说 真 的 。 注 释 总 是 一 种 失败 。 我 们 总 无 法 找到 不 用 注释 就 能 表达 自我 的 方法 ， 所 以 
总 要 有 注释 ， 这 并 不 值得 庆贺 。 

如 果 你 发 现 自己 需要 写 注释 ， 再 想 想 看 是 否 有 办 法 翻盘 ， 用 代码 来 表达 。 每 次 用 代 
码 表 达 ， 你 都 该 夸奖 一 下 目 己 。 每 次 写 注释 ， 你 都 该 做 个 鬼脸 ， 感 受 自 己 在 表达 能 力 上 ` 
的 失败 。 

我 为 什么 要 极力 贬低 注释 ? 因为 注释 会 撒谎 。 也 不 是 说 总 是 如 此 或 有 意 如 此 ， 但 出 现 得 
实在 太 频 繁 。 注 释 存 在 的 时 间 越 入 ， 就 离 其 所 描述 的 代码 越 远 ， 越 来 越 变 得 全 然 错 误 。 原 因 
很 简单 。 程 序 员 不 能 坚持 维护 注释 。 

代码 在 变动 ， 在 演化 。 从 这 里 移 到 那里 。 彼 此 分 离 、 重 造 又 合 到 一 处 。 很 不 幸 ， 注 释 并 
一 不 能 ， 。 注 释 常常 会 与 其 所 描述 的 代码 分 隔 开 来 ， 子 然 飘 零 ， 
越 来 越 不 准确 。 例 如 ， 看 看 以 下 注释 以 及 它 本 来 要 描述 的 代码 行 变 成 了 什么 样子 : 

MockRequest request; 

private final String HTTP_DATE REGEXP = 

" [SMTWF] [a-z] {2}\\,\\s[0-9] (2) N Ns [JFMASOND] [a-z] {2}\\s"+ 

"[0-9] (4}\\s [0-9] (215 N: [0-9] (2) N : [0-9] {2} \\sGMT"; 

private Response response; 

private FitNesseContext context; 

private FileResponder responder; 


private Locale saveLocale; 
. // Example: "Tue, 02 Apr 2003 22:18:49 GMT" 


ft HTTP DATE REGEXP 常量 及 其 注释 之 间 ， 有 可 能 插入 其 他 实体 变量 。 

程序 员 应 当 负 责 将 注释 保持 在 可 维护 、 有 关联 、 精 确 的 高 度 。 我 同意 这 种 说 法 。 但 我 更 
主张 把 力气 用 在 写 清楚 代码 上 ， 直 接 保 证 无 须 编写 注释 。 

不 准确 的 注释 要 比 没 注释 坏 得 多 。 它 们 满口 胡言 。 它 们 预期 的 东西 永 不 能 实现 。 它 们 设 
定 了 无 需 也 不 应 再 遵循 的 旧 规 则 。 

真实 只 在 一 处 地 方 有 : 代码 。 只 有 代码 能 忠实 地 告诉 你 它 做 的 事 。 那 是 唯一 真正 准确 的 
信息 来 源 。 所 以 ， 尽 管 有 时 也 需要 注释 ， 我 们 也 该 多 花心 思 尽 量 减 少 注释 量 











4.1 注释 不 能 美化 糟糕 的 代码 


写 注释 的 常见 动机 之 一 是 糟糕 的 代码 的 存在 。 我 们 编写 一 个 模块 ， 发 现 它 令 人 困扰 、 乱 
CW. RIME, CHAT. RISA: E, MESMER” T! 最 好 是 把 代码 于 
干净 ! 

带 有 少量 注释 的 整洁 而 有 表达 力 的 代码 ， 要 比 带 有 大 量 注释 的 零碎 而 复杂 的 代码 像样 得 
多 。 与 其 花 时 间 编 写 解释 你 搞 出 的 糟糕 的 代码 的 注释 ， 不 如 花 时 间 清 洁 那 堆 糟 糕 的 代码 。 
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4.2 用 代码 来 阐述 


有 时 ， 代 码 本 身 不 足以 解释 其 行为 。 不 幸 的 是 ，i 
有 的 话 一 一 能 做 好 解释 工作 。 这 种 观点 纯 属 错误 。 你 愿意 看 到 这 个 : 


// Check to see if the employee is eligible for full benefits 
if ((employee.flags & HOURLY FLAG) && 
(employee.age » 65)) 


还 是 这 个 ? 
if (employee. isEligibleForFullBenefits () ) 
只 要 想 上 那么 几 秒 钟 ， 就 能 用 代码 解释 你 大 部 分 的 意图 。 很 多 时 候 ， 简 单 到 只 需要 创建 
一 个 描述 与 注释 所 言 同一 事物 的 函数 即 可 。 








4.3 好 注释 


有 些 注释 是 必须 的 ， 也 是 有 利 的 。 来 看 看 一 些 我 认为 值得 写 的 注释 。 不 过 要 记 住 ， 唯 一 
真正 好 的 注释 是 你 想 办 法 不 SE 


43.1 法 律 信息 


有 时 ， 公 司 代码 规范 要 求 编写 与 法 律 有 关 的 注释 。 例 如 ， 版 权 及 著作 权 声 明 就 是 必须 和 
有 理由 在 每 个 源 文 件 开 头 注 释 处 放置 的 内 容 。 

下 例 是 我 们 在 ' FitNesse 项 目 每 个 源 文件 开头 放置 的 标准 注释 。 我 可 以 很 开心 地 说 ，IDE 
自动 卷 起 这 些 注 释 ， 这 样 就 不 会 显得 凌乱 了 。 


// Copyright (C) 2003,2004,2005 by Object Mentor, Inc. All rights reserved. 
// Released under the terms of the GNU General Public License version 2 or later. 


这 类 注释 不 应 是 合同 或 法 典 。 只 要 有 可 能 ， 就 指向 一 份 标准 许可 或 其 他 外 部 文档 ， 而 不 
要 把 所 有 条 款 放 到 注释 中 。 | | 


43.2 提供 信息 的 注释 
有 时 ， 用 注释 来 提供 基本 信息 也 有 其 用 处 。 例如， 以 下 注释 解释 了 某 个 抽象 方法 的 返回 值 ; 


// Returns an instance of the Responder being tested. 
protected abstract Responder responderInstance(); 
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这 类 注释 有 时 管用 ， 但 更 好 的 方式 是 尽量 利用 函数 名 称 传达 信息 。 比 如 ， 在 本 例 中 ， 只 
要 把 函数 重新 命名 为 responderBeingTested， 注 释 就 是 多 余 的 了 。 | 
下 例 稍 好 一 些 ; 


// format matched kk:mm:ss EEE, MMM dd, yyyy 
Pattern timeMatcher = Pattern.compile( 


"\\d*:\\d*:\\d* \\w*, \\w* \\d*, Nem; 


在 本 例 中 ， 注 释 说 明 ， 该 正则 表达 式 意 在 匹配 一 个 经 由 SimpleDateFormat.format 函数 利 
用 特定 格式 字符 串 格 式 化 的 时 间 和 日 期 。 同 样 ， 如 果 把 这 段 代 码 移 到 某 个 转换 日 期 和 时 间 格 
式 的 类 中 ， 就 会 更 好 、 更 清晰 ， 而 注释 也 就 变 得 多 此 一 举 了 。 


4.3.3 对 意图 的 解释 


有 时 ， 注 释 不 仅 提供 了 有 关 实 现 的 有 用 信息 ， 而 且 还 提供 了 某 个 决定 后 面 的 意图 。 在 下 
例 中 ， 我 们 看 到 注释 反映 出 来 的 一 个 有 趣 决 定 。 在 对 比 两 个 对 象 时 ， 作 者 决定 将 他 的 类 放置 
在 比 其 他 东西 更 高 的 位 置 。 


public int compareTo (Object o) 
{ 
if(o instanceof WikiPagePath) 
{ | 
WikiPagePath p = (WikiPagePath) o; 
String compressedName - StringUtil.join(names, ""); 
String compressedArgumentName - StringUtil.join(p.names, ""); 
return compressedName.compareTo (compressedArgumentName); 
) 
return 1; // we are greater because we are the right type. 


} 


下 面 的 例子 甚至 更 好 。 你 也 许 不 同意 程序 员 给 这 个 问题 提供 的 解决 方案 ， 但 至 少 你 知道 
他 想 干什么 。 : 


public void testConcurrentAddWidgets() throws Exception { 

WidgetBuilder widgetBuilder - 

new WidgetBuilder (new Class[]{BoldWidget.class}); _ 
String text = "'''bold text'''"; 
ParentWidget parent = 

new BoldWidget (new MockWidgetRoot(), "'''bold text'''"); 
AtomicBoolean failFlag = new AtomicBoolean(); 
failFlag.set(false); 


//This is our best attempt to get a race condition 
//by creating large number of threads. 
for (int i = 0; i < 25000; i++) { 
WidgetBuilderThread widgetBuilderThread = 
new WidgetBuilderThread(widgetBuilder, text, parent, failFlag); 
Thread thread = new Thread(widgetBuilderThread); 
thread.start(); 
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} 
assertEquals(false, failFlag.get()); 


) 


434 BRE 


有 时 , ERER SREE AAA R [ELE EI E OC E ATARI TES, 也 会 是 有 用 的 。 
通常 ， 更 好 的 方法 是 尽量 让 参数 或 返回 值 自身 就 足够 清楚 ， 但 如 果 参 数 或 返回 值 是 某 个 标准 
库 的 一 部 分 ， 或 是 你 不 能 修改 的 代码 ， 帮 助 阐释 其 含义 的 代码 就 会 有 用 。 


public void testCompareTo() throws Exception 

{ 
WikiPagePath a = PathParser.parse("PageA"); 
WikiPagePath ab = PathParser.parse("PageA.PageB"); 
WikiPagePath b = PathParser.parse ("PageB"); 
WikiPagePath aa = PathParser.parse("PageA.PageA"); 
WikiPagePath bb = PathParser.parse("PageB.PageB"); 
WikiPagePath ba = PathParser.parse("PageB.PageA"); 


assertTrue(a.compareTo(a) == 0); // a == a 
assertTrue(a.compareTo(b) != 0); // a != b 
assertTrue(ab.compareTo(ab) == 0); // ab == ab 
assertTrue(a.compareTo(b) == -1); //a<b 
assertTrue(aa.compareTo(ab) == -1); // aa < ab 
assertTrue(ba.compareTo(bb) -- -1); // ba « bb 
assertTrue(b.compareTo(a) -- 1); //b»a 
assertTrue(ab.compareTo(aa) == 1); // ab > aa 
assertTrue(bb.compareTo(ba) -- 1); // bb » ba 


} 

当然 ， 这 也 会 冒 阐释 性 注释 本 身 就 不 正确 的 风险 。 回 头 看 看 上 例 ， 你 会 发 现 想 要 确认 注 
释 的 正确 性 有 多 难 。 这 一 方面 说 明了 盖 杰 有 多 必要 ， 另 外 也 说 明了 它 有 风险 。 所 以 ， 在 写 这 
类 注释 之 前 ， 考 虑 一 下 是 否 还 有 更 好 的 办 法 ， 然 后 再 加 倍 小 心地 确认 注释 正确 性 。 
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435 警示 


有 时 ， 用 于 警告 其 他 程序 员 会 出 现 茶 种 后 果 的 注释 也 是 
有 用 的 。 例 如 ， 下 面 的 注释 解释 了 为 什么 要 关闭 茶 个 特定 的 
测试 用 例 : 


// Don't run unless You 

// have some time to kill. 

public void _testWithReallyBigFile() 

| 
writeLinesToFile(10000000); 





response.setBody (testFile); 
response.readyToSend (this); 
String responseString = output.toString(); 
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assertSubString("Content-Length: 1000000000", responseString); 
assertTrue(bytesSent » 1000000000); | 
) 


当然 ， 如 今 我 们 多 数 会 利用 附 上 恰当 解释 性 字符 串 的 @Ignore 属性 来 关闭 测试 用 例 。 
如 @Ignore("Takes too long to run")。 但 在 JUnit4 之 前 的 日 子 里 ， 惯 常 的 做 法 是 在 方法 名 d 
加 上 下 划 线 。 如 果 注 释 足 够 有 说 服 力 ， 就 会 很 有 用 了 。 | 
这 里 有 个 更 麻烦 的 例子 : 


public static SimpleDateFormat makeStandardHttpDateFormat () 
( | ; 
//SimpleDateFormat is not thread safe, 

//so we need to create each instance independently. 

SimpleDateFormat df = new SimpleDateFormat ("EEE, dd MMM yyyy HH:mm:ss 2"); 
df.setTimeZone (TimeZone.getTimeZone ("GMT")); 

return df; 


你 也 许 会 抱怨 说 ， 还 会 有 更 好 的 解决 方法 。 我 大 概 会 同意 。 不 过 上 面 的 注释 绝对 有 道理 
存在 ， 它 能 阻止 某 位 急切 的 程序 员 以 效率 之 名 使 用 静态 初始 器 。 


43b TODOTERE 


有 时 ， 有 理由 用 /TODO 形式 在 源 代 码 中 放置 要 做 的 工作 列表 。 在 下 例 中 ，TODO 注释 
解释 了 为 什么 该 函数 的 实现 部 分 无 所 作为 ， 将 来 应 该 是 怎样 。 


//TODO-MdM these are not needed 
// We expect this to go away when we do the checkout model 
protected VersionInfo makeVersion() throws Exception 


{ 


return null; 


TODO 是 一 种 程序 员 认为 应 该 做 ， 但 由 于 某 些 原 因 目 前 还 没 做 的 工作 。 它 可 能 是 要 提醒 
删除 某 个 不 必要 的 特性 ， 或 者 要 求 他 人 注意 某 个 问题 。 它 可 能 是 恳请 别人 取 个 好 名 字 ， 或 者 
提示 对 依赖 于 茶 个 计划 事件 的 修改 。 无 论 TODO 的 目的 如 何 ， 它 都 不 TOM 留 下 糟糕 的 
代码 的 借口 。 

如 今 , KE Be IDE 都 提供 了 特别 的 手段 来 定位 所 有 TODO 注释 , 这 些 注释 看 来 丢 不 了 。 
你 不 会 愿意 代码 因为 TODO 的 存在 而 变 成 一 堆 垃 圾 ， 所 以 要 定期 查看 ， 删 除 不 再 需要 的 。 


43.7 放大 


注释 可 以 用 来 放大 某 种 看 来 不 合理 之 物 的 重要 性 。 


‘PRE: 意 为 “运行 时 间 过 长 ”。 
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String listItemContent = match.group(3).trim(); 

// the trim is real important. It removes the starting 
// spaces that could cause the item to be recognized 

// as another list. 

new ListItemWidget (this, listItemContent, this.level + 1); 
return buildList (text.substring(match.end())); 


438 公共 API 中 的 Javadoc 


没有 什么 比 被 良好 描述 的 公共 API 更 有 用 和 令 人 满意 的 了 。 标 准 Java 库 中 的 Javadoc 就 
是 一 例 。 没 有 它们 ， 写 lava 程序 就 会 变 得 很 难 。 

如 果 你 在 编写 公共 APL MAN CHWS REN Javadoc。 不 过 要 记 住 本 章 中 的 其 他 建议 。 
就 像 其 他 注释 一 样 ，Javadoc 也 可 能 误导 、 不 适用 或 者 提供 错误 信息 。 mE 


44 Ni 


AS SIERRA. ETE, WERE RN NB RO, RANE RRR 
修正 ， 基 本 上 等 于 程序 员 自 说 自 话 。 


44.1 [SEIS 


如 果 只 是 因为 你 觉得 应 该 或 者 因为 过 程 需要 就 添加 注释 ， 那 就 是 无 谓 之 举 。 如 果 你 决定 
写 注释 ， 就 要 花 必要 的 时 间 确 保 写 出 最 好 的 注释 。 

例如 ， 我 在 FitNesse 中 找到 的 这 个 例子 ， 例 中 的 注释 大 概 确实 有 用 。 不 过 ， 作 者 太 着 急 ， 
或 者 没 太 花心 思 。 他 的 喃 喃 目 语 变 成 了 一 个 谜团 。 


public void loadProperties() 
| 
try 
( 
String propertiesPath = propertiesLocation + "/" + PROPERTIES FILE; 
FilelInputStream propertiesStream = new FileInputStream(propertiesPath) ; 
loadedProperties.load(propertiesStream); | 
) 
catch(IOException e) 
( i 
// No properties files means all defaults are loaded 
) 
) 


catch 代码 块 中 的 注释 是 什么 意思 呢 ? 显然 对 于 作者 有 其 意义 , 不 过 并 没有 好 到 足够 的 程 
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度 。 很 明显 ， 如 果 出 现 IOException， 融 表示 没有 属性 文件 ， 在 那 种 情况 下 ， 载 入 默认 设置 。 
但 谁 来 装载 默认 设置 呢 ? 会 在 对 loadProperties.load 之 前 装载 吗 ? 抑或 loadProperties.load 捕 获 
异常 、 装 载 默认 设置 、 再 向 上 传递 异常 ? 再 或 loadProperties.load 在 尝试 载 入 文件 前 就 装载 所 
有 默认 设置 ? 要 么 作者 只 是 在 安奈 自己 别 在 意 catch 代码 块 的 留 空 ? 或 者 一 一 这 种 可 能 最 可 
怕 一 一 作者 是 想 告 诉 上 自己 ， 将 来 再 回头 写 装载 默认 设置 的 代码 ? 

我 们 唯 有 检视 系统 其 他 部 分 的 代码 , 弄 清 事情 原委 。 任何 迫使 读者 查看 其 他 模块 的 注释 ， 
都 没 能 与 读者 沟通 好 ， 不 值 所 费 。 | 


442 BRYER 


代码 清单 4-1 展示 的 简单 函数 ， 其 头 部 位 置 的 注释 全 属 多 余 。 读 这 段 注释 花 的 时 间 没 准 
比 读 代码 花 的 时 间 还 要 长 。 


代码 清单 4-1 waitForClose 


// Utility method that returns when this.closed is true. Throws an exception 
// if the timeout is reached. 
public synchronized void waitForClose(final long timeoutMillis) 
throws Exception 
{ 
if (!closed) 
{ 


wait (timeoutMillis); 
if(!closed) 
throw new Exception("MockResponseSender could not be closed"); 
) | "m 
这 段 注释 起 了 什么 作用 ? 它 并 不 能 比 代码 本 身 提 供 更 多 的 信息 。 它 没有 证 明代 码 的 意义 ， 
也 没有 给 出 代码 的 意图 或 逻辑 。 读 它 并 不 比 读 代 码 更 容易 。 事 实 上 ， 它 不 如 代码 精确 ， 误 导 
读者 接受 不 精确 的 信息 ， 而 不 是 正确 地 理解 代码 。 它 就 像 个 自 来 熟 的 二 手 车 贩子 ， 满 口 保 证 
你 不 用 打开 发 动机 盖 查验 。 
来 看 看 代码 清单 4-2 中 摘自 Tomcat 项 目的 无 用 而 多 余 的 Javadoc 吧 。 这 些 注释 只 是 一 味 
将 代码 搞 得 含糊 不 明 。 完 全 没有 文档 上 的 价值 。 下 面 只 列 出 了 靠 前 面 的 一 些 代码 ， 后 续 模 块 
中 还 有 许多 类 似 情况 。 


代码 清单 4-2 ContainerBase.java (Tomcat) 


public abstract class ContainerBase 
implements Container, Lifecycle, Pipeline, 
MBeanRegistration, Serializable { 


/** 
* The processor delay for this component. 


£% 


protected int backgroundProcessorDelay = -1; 


/** 
* The lifecycle event support for this component. 
wi 
protected LifecycleSupport lifecycle = 
new LifecycleSupport (this); 


/** 

* The container event listeners for this Container. 
x / 

protected ArrayList listeners = new ArrayList(); 


/** 
* The Loader implementation with which this Container is 
* associated. 

Wi 
protected Loader loader = null; 


/** 

* The Logger implementation with which this Container is 
* associated. 

*/ 

protected Log logger - null; 


/** 

* Associated logger name. 

my 

protected String logName = null; 


/** 

* The Manager implementation with which this Container is 
* associated. 

d | 


protected Manager manager = null; 


/** 
* The cluster with which this Container is associated. 
Wi 


protected Cluster cluster = null; 


II 
* The human-readable name of this Container. 
*/ 


protected String name = null; 


/** 
* The parent Container to which this Container is a child. 
*/. 


protected Container parent = null; 


/** 
* The parent class loader to be configured when we install 
* Loader. 
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protected ClassLoader parentClassLoader = null; 


/** 
* The Pipeline object with which this Container is 
* asSociated. 
Wi 
protected Pipeline pipeline = new StandardPipeline (this); 


/** 
* The Realm with which this Container is associated. 
x/ 


protected Realm realm = null; 


/** 
* The resources DirContext object with which this Container 


* is associated. 
*/ 


protected DirContext resources - null; 
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有 了 时， 尽管 初衷 可 嘉 ， 程 序 员 还 是 会 写 出 不 够 精确 的 注释 。 想 想 看 代码 清单 4-1 中 那 多 
余 而 又 有 误导 嫌疑 的 注释 吧 。 

你 有 没有 发 现 那样 的 注释 是 如 何 误导 读者 的 ? 在 this closed 变 为 true 的 时 候 ， 方 法 并 没 
有 返回 。 方 法 只 在 判断 到 this.closed 为 true 的 时 候 返 回 ， 否 则 ， 就 只 是 等 待 遥遥 无 期 的 超时 ， 
然后 如 果 判 断 this.closed 还 是 非 tme， 就 抛 出 一 个 异常 。 

这 一 细微 的 误导 信息 ， 放 在 比 代 码 本 身 更 难 阅读 的 注释 里 面 ， 有 可 能 导致 其 他 程序 员 快 
活 地 调用 这 个 函数 ， 并 期 望 在 this.closed BA true 时 立即 返回 。 那 位 可 怜 的 程序 员 将 会 发 现 
自己 陷于 调试 困境 之 中 ， 拼 命 想 找 出 代码 执行 得 如 此 之 慢 的 原因 。 


AAA {EA ERE 


所 谓 每 个 函数 都 要 有 Javadoc 或 每 个 变量 都 要 有 注释 的 规矩 全 然 是 思春 可 笑 的 。 这 类 注 
释 徒 然 让 代码 变 得 散乱 ， 满 口 胡 言 ， 令 人 迷惑 不 解 。 

例如 ， 要 求 每 个 函数 都 要 有 Javadoc， 就 会 得 到 类 似 代 码 清单 4-3 那样 面目 可 恼 的 代码 。 
这 类 废话 只 会 搞 乱 代码 ， 有 可 能 误导 读者 。 


代码 清单 4-3 
/* * 


* @param title The title of the CD 
* (iparam author The author of the CD 
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* @param tracks The number of tracks on the CD 
* (param durationInMinutes The duration of the CD in minutes 
WI 
public void addCD(String title, String author, 
int tracks, int durationInMinutes) { 
CD cd = new CD(); 
cd.title = title; 
cd.author = author; 
cd.tracks = tracks; 
cd.duration = duration; 
cdList.add(cd); 


445 日 志 式 注释 


Act, CORALS NIE. OER maen 
修改 的 日 志 。 我 见 过 潢 篇 尽 是 这 类 日 志 的 代码 模块 


* Changes (from 11-Oct-2001) 


* 11-Oct-2001 : Re-organised the class and moved it to new package 
|. com.jrefinery.date (DG); 

05-Nov-2001 : Added a getDescription() method, and eliminated NotableDate 
class (DG); 

12-Nov-2001 : IBD requires setDescription() method, now that NotableDate 
class is gone (DG); Changed getPreviousDayOfWeek(), 
getFollowingDayOfWeek() and getNearestDayOfWeek() to correct 
bugs (DG); 

05-Dec-2001 : Fixed bug in SpreadsheetDate class (DG); 

29-May-2002 : Moved the month constants into a separate interface 
(MonthConstants) (DG); 

27-Aug-2002 : Fixed bug in addMonths() method, thanks to N???levka Petr (DG); 

03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

13-Mar-2003 : Implemented Serializable (DG); 

29-May-2003 : Fixed bug in addMonths method (DG); 

04-Sep-2003 : Implemented Comparable. Updated the isInRange javadocs (DG); 

05-Jan-2005 : Fixed bug in addYears() method (1096282) (DG); 


很 久 以 前 ， 在 模块 开始 处 创建 并 维护 这 些 记 录 还 算 有 道理 。 那 时 ， 我 们 还 没有 源 代 码 控 
制 系 统 可 用 。 如 今 ， 这 种 元 长 的 记录 只 会 让 模块 变 得 凌乱 不 堪 ， 应 当 全 部 删除 。 


445 废话 注释 


有 时 ， 你 会 看 到 纯 然 是 废话 的 注释 。 它 们 对 于 显然 之 事 唆 喉 不 休 ， 毫 无 新 意 。 
/** 


* Default constructor. 
x} 
protected AnnualDateRule() { 


+ + + 0€ 0X FF 49 zz 
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XE? 再 看 看 这 个 : 


/** The day of the month. */ 
private int dayOfMonth; 


还 有 这 样 的 废话 模范 : 

IT 

* Returns the day of the month. 
$ | 


* @return the day of the month. 

my 

public int getDayOfMonth() { 
return dayOfMonth; 

} 


这 类 注释 废话 连篇 ， 我 们 都 学 会 了 视而不见 。 读 代码 时 ， 眼 光 不 会 停留 在 它们 上 面 。 最 
终 ， 当 代码 修改 之 后 ， 这 类 注释 就 变 作 了 谎言 一 堆 。 — 

代码 清单 4-4 中 的 第 一 条 注释 貌似 还 行 。 它 解释 了 catch 代码 块 为 何 被 忽略 。 不 过 第 二 
条 注释 就 纯 是 废话 了 。 显 然 ， 该 程序 员 诅 丧 于 编写 函数 中 那些 try/catch 代码 块 。 


代码 清单 4-4  startSending 


private void startSending () 
{ 
try 
{ 
doSending(); 


) 
catch(SocketException e) 


( 
// normal. someone stopped the request. 


) 
catch(Exception e) 
{ 
try 
{ | 
response.add (ErrorResponder.makeExceptionString(e)); 
response.closeAll (); 


} 
catch (Exception el) 
{ 
// Give me a break! 
} 
} 
) 


与 其 纠缠 于 毫 无 价值 的 废话 注释 ,程序 员 应 该 意识 到 ,他 的 挫败 感 可 以 由 改进 代码 结构 而 消 
除 。 他 应 该 把 力气 花 在 将 最 末 一 个 try/catch 代码 块 拆 解 到 单独 的 函数 中 ， 如 代码 清单 4.5 所 示 。 


AÈ: DE 对 注释 中 拼写 检查 的 支持 对 我 们 这 些 看 大 量 代码 的 人 实在 是 一 种 妙 事 。 


“4.4 坏 注 释 61 


代码 清单 4-5 startSending 〈 重 构 之 后 ) 


private void startSending() 


{ 
try 
{ 


} 


doSending(); 


catch (SocketException e) 


{ 


//normal. someone stopped the request. 


} 


catch(Exception e) 


{ 


addExceptionAndCloseResponse (e); 


) 
) 


{ 
try 
{ 


private void addExceptionAndCloseResponse (Exception e) 


response. add (ErrorResponder.makeExceptionString (e) ); 
response.closeAll (); 


} 


catch (Exception el) 


{ 
} 
} 


用 整理 代码 的 决心 替代 创造 废话 的 冲动 吧 。 你 会 发 现 自己 成 为 更 优秀 、 更 快乐 的 程序 员 。 
44.7 ”可 由 的 废话 


Javadoc 也 可 能 是 废话 。 下 列 Javadoc〈 来 自 某 知 名 开源 库 ) 的 目的 是 什么 ? BR: 无 。 
它们 只 是 源 自 某 种 提供 文档 的 不 当 愿 望 的 废话 注释 。 


/** The 
private 


/** The 
private 


/** The 
private 


/** The 


private 


name. */ 
String name; 


version. */ 
String version; 


licenceName. */ 
String licenceName; 


version. */ 
String info; 


Migne 你 是 否 发 现 了 剪 切 -粘贴 错误 ? 如 采 作 者 在 号 (BORGO 注释 时 都 
没 花心 思 ， 怎 么 能 指望 读者 从 中 获 益 呢 ? 
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4.4.8 能 用 郧 数 或 变量 时 就 别 用 注 
看 看 以 下 代码 概要 : 


// does the module from the global list «mod» depend on the 
// subsystem we are part of? 
if (smodule.getDependSubsystems ().contains (subSysMod.getSubSystem())) 


可 以 改 成 以 下 没有 注释 的 版 本 : 


ArrayList moduleDependees = smodule.getDependSubsystems () ; 
String ourSubSystem = subSysMod.getSubSystem(); 
if (moduleDependees.contains (ourSubSystem)) 


代码 原作 者 可 能 《〈 不 太 像 ) 是 先 写 注释 再 编写 代码 。 不 过 ， — 如 我 所 
做 的 那样 ， 从 而 删 掉 注释 。 


449 位 置 标记 


Att, 程序 员 喜 欢 在 源 代码 中 标记 某 个 特别 位 置 。 例 如 ， 最 近 我 在 程序 中 看 到 这 样 一 行 
// Actions 017170777777717771117111111711111111111 


把 特定 函数 全 放 在 这 种 标记 栏 下 面 ， 多 数 时 候 实 属 无 理 。 鸡 零 狗 碎 ， 理 当 删 除 一 一 特别 
是 尾部 那 一 长 串 无 用 的 斜 杠 。 | 

这 么 说 吧 。 如 果 标 记 栏 不 多 ， 就 会 显而易见 。 所 以 ， 尽 量 少 用 标记 栏 ， 只 在 特别 有 价值 
的 时 候 用 。 如 果 滥 用 标记 栏 ， 就 会 沉没 在 背景 噪音 中 ， 被 忽略 掉 。 


4.4.10 括号 后 DABI 


有 时 ， 程 序 员 会 在 括号 后 面 放置 特殊 的 注释 ， 如 代码 清单 4.6 所 示 。 尽管 这 对 于 含有 深 
度 嵌 套 结构 的 长 函数 可 能 有 意义 ， 但 只 会 给 我 们 更 愿意 编写 的 短小 、 封 装 的 函数 带 来 泥 乱 。 
如 果 你 发 现 自己 想 标记 右 括号 ， 其 实 应 该 做 的 是 缩短 函数 。 


代码 清单 4-6 we.java 
public class wc ( 
public static void main(String[] args) { 
BufferedReader in = new BufferedReader (new InputStreamReader (System. in)); 
String line; 
int lineCount 
int charCount 
int wordCount 
try { 
while ((line = in.readLine()) != null) ( 


0 
0; 
0 
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lineCount**; 
charCount += line.length(); 
String words[] = line.split("\\W"); 
wordCount += words.length; 
) //while 
System.out. Spine imi verdesunt 
System.out.println("lineCount 
System.out. println("charCount 
) // try 
catch (IOException e) { Ko . 
System.err.println("Error:" + e.getMessage()); 
) //catch 
) //main 


) 


" 4 wordCount); 
" + lineCount); 
" + charCount); 


4411 归属 与 署名 


/* Added by Rick */ 


源 代码 控制 系统 非常 善于 记 住 是 准 在 何 时 添加 了 什么 。 没 必要 用 那些 小 小 的 签名 搞 脏 代 
码 。 你 也 许 会 认为 ， 这 种 注释 大 概 有 助 于 他 人 了 解 应 该 和 谁 讨论 这 段 代码 。 不 过 ， 事 实 却 是 
注释 在 那儿 放 了 一 年 又 一 年 ， 越 来 越 不 准确 ， 越 来 越 和 原作 者 没关系 。 

重申 一 下 ， 源 代码 控制 系统 是 这 类 信息 最 好 的 归属 地 。 


44.12 注释 掉 的 代码 


直接 把 代码 注释 掉 是 讨厌 的 做 法 。 别 这 么 干 ! 


InputStreamResponse response = new InputStreamResponse(); 
response.setBody(formatter.getResultStream(), formatter.getByteCount ()); 
// InputStream resultsStream = formatter.getResultStream () ; 
// StreamReader reader = new StreamReader (resultsStream) ; 
.//  response.setContent (reader. read (formatter.getByteCount () ) ) ; 


其 他 人 不 敢 删除 注释 掉 的 代码 。 他 们 会 想 ， 代 码 依然 放 在 那儿 ， 一 定 有 其 原因 ， 而 且 这 
段 代 码 很 重要 ， 不 能 删除 。 注 释 掉 的 代码 堆积 在 一 起 ， 就 像 破 酒 瓶 底 的 渣 淳 一 般 。 
看 看 以 下 来 自 Apache 公共 库 的 代码 ; 


this.bytePos = writeBytes(pngIdBytes, 0); 
//hdrPos s bytePos; 
writeHeader(); 
writeResolution(); 
//dataPos = bytePos; 
if (writeImageData()) { 
writeEnd(); 
this.pngBytes = resizeByteArray(this.pngBytes, this.maxPos); 
) 
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else( 
this.pngBytes-null; 

) 

return this.pngBytes; 


这 两 行 代码 为 什么 要 注释 掉 ? 它们 重要 吗 ? 它们 搁 在 那儿 ， 是 为 了 给 未 来 的 修改 做 提示 
"i? 或 者 ， 只 是 某 入 在 多 年 以 前 注释 掉 、 懒 得 清理 的 过 时 玩意 ? | | 

20 世纪 60 年 代 ， 曾 经 有 那么 一 段 时 间 ， 注 释 掉 的 代码 可 能 有 用 。 但 我 们 已 经 拥有 优良 
的 源 代码 控制 系统 如 此 之 久 ， 这 些 系统 可 以 为 我 们 记 住 不 要 的 代码 。 我 们 无 需 再 用 注释 来 标 
记 ， 删 掉 即 可 ， 它 们 丢 不 了 。 我 担保 。 


4.4.13 HTML 注释 


源 代码 注释 中 的 HTML 标记 是 一 种 厌 物 ， 如 你 在 下 面 代码 中 所 见 。 编 辑 器 /IDE 中 的 代码 

本 来 易于 阅读 ， 却 因为 HTML 注释 的 存在 而 变 得 难以 座 读 。 如 果 注 释 将 由 某 种 工具 〈 例 如 
Javadoc) 抽取 出 来 ， 呈 现 到 网 页 ， 那 么 该 是 工具 而 非 程序 员 来 负责 给 注释 加 上 合适 的 HTML 
”标签 。 | | 

/** 

* Task to run fit tests. 

* This task runs fitnesse tests and publishes the results. 

* <p/> 

* <pre> 

* Usage: i 

* &lt;taskdef name=&quot;execute-fitnesse-tests&quot; 

g classname-&quot;fitnesse.ant.ExecuteFitnesseTestsTask&quot; 

* classpathref-&quot;classpath&quot; /&gt; 

* OR 

* &lt;taskdef classpathref-&quot;classpath&quot; 

* resource-&quot;tasks.properties&quot; /&gt; 

* <p/> | 
* &lt;execute-fitnesse-tests 
* suitepage-&quot; FitNesse.SuiteAcceptanceTests&quot; 
* fitnesseport-&quot;8082&quot; | | 
* resultsdir=&quot;${results.dir} &quot; 
* resultshtmlpage-&quot;fit-results.html&quot; 
* classpathref-&quot;classpath&quot; /&gt; 
* </pre> | 
*/ i 


44.14 _ 非 二 地 信息 


假如 你 一 定 要 写 注释 ， 请 确保 它 描述 了 离 它 最 近 的 代码 。 别 在 本 地 注释 的 上 下 文 环 境 中 
给 出 系统 级 的 信息 。 以 下 面 的 Javadoc 注释 为 例 ， 除 了 那 可 怕 的 元 余 之 外 ， 它 还 给 出 了 有 关 
默认 端口 的 信息 。 不 过 该 函数 完全 没 控制 到 那个 所 谓 默认 值 。 这 个 注释 并 未 描述 该 函数 ， 而 
是 在 描述 系统 中 远 在 他 方 的 其 他 函数 。 当 然 ,也 无 法 担保 在 包含 那个 默认 值 的 代码 修改 之 后 ， 
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这 里 的 注释 也 会 跟着 修改 。 


/** 
* Port on which fitnesse would run. Defaults to <b>8082</b>. 
* 
* (param fitnessePort 
di | 
public void setFitnessePort(int fitnessePort) 
( 
this.fitnessePort = fitnessePort; 


) 


44.15 信息 过 多 


别 在 注释 中 添加 有 趣 的 历史 性 话题 或 者 无 关 的 细节 描述 。 下 列 注释 来 自 某 个 用 来 测试 
base64 编 解码 函数 的 模块 。 除 了 RFC 文档 编号 之 外 , 注释 中 的 其 他 细节 信息 对 于 读者 完全 没 
有 必要 。 


| | 
RFC 2045 - Multipurpose Internét Mail Extensions (MIME) 

Part One: Format of Internet Message Bodies 

section 6.8. Base64 Content-Transfer-Encoding 

The encoding process represents 24-bit groups of input bits as output 
strings of 4 encoded characters. Proceeding from left to right, a 
24-bit input group is formed by concatenating 3 8-bit input groups. 
These 24 bits are then treated as 4 concatenated 6-bit groups, each 
of which is translated into a single digit in the base64 alphabet. 
When encoding a bit stream via the base64 encoding, the bit stream 
must be presumed to be ordered with the most-significant-bit first. 
That is, the first bit in the stream will be the high-order bit in 
the first 8-bit byte, and the eighth bit will be the low-order bit in 
the first 8-bit byte, and so on. 

*/ 


4.4.15 不 明显 的 联系 


注释 及 其 描述 的 代码 之 间 的 联系 应 该 显而易见 。 如 果 你 不 嫌 麻 烦 要 写 注释 ， 至 少 让 读者 
能 看 着 注释 和 代码 ， 并 且 理 解 注 释 所 谈 何 物 。 | 

以 来 自 Apache 公共 库 的 这 段 注释 为 例 : 

start with an array that is big enough to hold all the pixels 

* (plus filter bytes), and an extra 200 bytes for header info 

SE 

this.pngBytes = new byte[((this.width + 1) * this.height * 3) + 200]; 

过 滤器 字 节 是 什么 ? 与 那个 +1 有 关系 吗 ? 或 与 *3 AK? CESMARAR? 为 什么 用 
200? 注释 的 作用 是 解释 未 能 自行 解释 的 代码 。 如 果 注 释 本 身 还 需要 解释 ， 就 太 遗 憾 了 。 
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44.17 RA 
短 函 数 不 需要 太 多 描述 。 为 只 做 一 件 事 的 短 函 数 选 个 好 名 字 , 通常 要 比 写 函 数 头 注释 要 好 。 
4418 _ 非 公共 代码 中 的 Javadoc | 


虽然 Javadoc 对 于 公共 API 非常 有 用 ， 但 对 于 不 打算 作 公共 用 途 的 代码 就 令 人 厌恶 了 。 
为 系统 中 的 类 和 函数 生成 Javadoc 页 并 非 总 有 用 , 而 Javadoc 注释 额外 的 形式 要 求 几 乎 等 同 于 
八股 文章 。 | 


4.4.19 范例 


我 曾 为 首 个 XP Immersion 课程 编写 了 代码 清单 4-7 列 出 的 模块 。 这 个 模块 几乎 是 糟糕 的 
代码 和 坏 注 释 风 格 的 典范 。 后 来 Kent Beck 当 着 几 十 位 满腔 热情 的 学 生 的 面 重 构 了 这 些 代码 ， 
将 其 变 得 令 人 愉悦 。 后 来 ， 我 在 拙 著 Agile Software Development, Principles, Patterns, and 
Practices《〈 中 译 版 《敏捷 软件 开发 : 原则、 模式 与 实践 》》 和 Software Development (KAFF 
发 ) 杂志 的 “技艺 ”专栏 的 第 一 篇 文章 中 引用 了 这 个 例子 。 

这 个 模块 最 迷人 的 地 方 是 ， 有 那么 一 阵 ， 我 们 中 的 许多 人 都 认为 它 “ 文 档 做 得 很 好 ”。 如 
今 ， 我 们 认为 它 是 一 小 团 乱 麻 。 看 看 你 能 发 现 多 少 个 不 同 的 注释 问题 吧 ，。 


代码 清单 4-7 GeneratePrimes.java 
/** 


* 


This class Generates prime numbers up to a user specified 
maximum. The algorithm used is the Sieve of Eratosthenes. 
Xp» 

Eratosthenes of Cyrene; b. c. 276 BC, Cyrene, Libya -- 

d. c. 194, Alexandria: The first man to calculate the 
circumference of the Earth. Also known for working on 
calendars with leap years and ran the library at Alexandria. 
<p> 

The algorithm is quite simple. Given an array of integers 
starting at 2. Cross out all multiples of 2. Find the next 
uncrossed integer, and cross out all of its multiples. 
Repeat untilyou have passed the square root of the maximum 
value. 


+ + + +*+ 00€ HH SH HH HH 0t FH HH ot ox 


@author Alphonse 
@version 13 Feb 2002 atp 
tf 


import java.util.*; 


! 译注 : Object Mentor 公司 开办 的 极限 编程 深入 课程 。 
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public class GeneratePrimes 
{ 
II 
* (param maxValue is the generation limit. 
* / : 
public static int[] generatePrimes(int maxValue) 


{ 


if (maxValue >= 2) // the only valid case 
{ 
// declarations 
int s = maxValue + 1; // size of array 
boolean[] f = new boolean[s]; 
int i; 
// initialize array to true. 
for (i = 0; i < s; itt) 

f[i] = true; | 
// get rid of known non-primes 
f[0] = £[1] = false; 
// sieve 
int j; 
for (i = 2; i < Math.sqrt(s) + 1; i++) 
{ | 
if (f[i]) // if i is uncrossed, cross its multiples. 
{ 

for (jJ = 2 * i; j < s; j += i) 

f[j] = false; // multiple is not prime 

} 
} 


// how many primes are there? 
int count = 0; 
for (i = 0; i < s; itt) 
{ 
if (f[i]) 
count**; // bump count. 
) tS 4s 


int[] primes = new int[count]; 


// move the primes into the result 
for (1 = 0, j= 0; i< s; itt) 
{ 
if (f[i]) // if prime 
primes[j++] = i; 
} 


return primes; // return the primes 
} | 
else // maxValue < 2 

return new int[0]; // return null array if bad input. 
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在 代码 清单 4-8 中 ， 你 可 以 看 到 该 模块 重 构 后 的 版 本 。 注 意 ， 注 释 的 使 用 被 明显 地 限制 
了 。 在 整个 模块 中 只 有 两 个 注释 。 每 个 注释 都 足 具 说 明 意 义 。 


代码 清单 4-8 PrimeGenerator.java (EHA) 





* This class Generates prime numbers up to a user specified 
* maximum. The algorithm used is the Sieve of Eratosthenes. 
* Given an array of integers starting at 2: 

* Find the first uncrossed integer, and cross out all its 

* multiples. Repeat until there are no more multiples 

* in the array. 


public class PrimeGenerator , 
{ 

private static boolean[] crossedOut; 

private static int[] result; 


public static int[] generatePrimes(int maxValue) 
{ 
if (maxValue < 2) 
return new int[0]; 
else 
{ 
uncrossIntegersUpTo (maxValue); 
crossOutMultiples(); 
putUncrossedIntegersIntoResult(); 
return result; 
) 
) 


private static void uncrossIntegersUpTo(int maxValue) 
{ 
crossedOut = new boolean[maxValue + 1]; 
for (int i = 2; i < crossedOut.length; i++) 
crossedOut[i] = false; 


) 


private static void crossOutMultiples () 
{ | 
int limit = determineIterationLimit(); 
for (int i = 2; i <= limit; i++) 
if (notCrossed(i)) 
crossOutMultiplesOf (i); 
) 


private static int determineIterationLimit () 

{ 
// Every multiple in the array has a prime factor that 
// is less than or equal to the root of the array size, 
// so we don't have to cross out multiples of numbers 
// larger than that root. 
double iterationLimit = Math.sqrt(crossedOut.length); 
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return (int) iterationLimit; 


) 


private static void crossOutMultiplesOf(int i) 
( i 
for (int multiple = 2*i; 
multiple < crossedOut.length; 
multiple += i) | 
crossedOut[multiple] = true; 


) 


private static boolean notCrossed(int i) 


{ 


return crossedOut[i] == false; 


) 


private static void putUncrossedIntegersIntoResult () 
{ 
result. = new int[numberOfUncrossedIntegers ()]; 
for (int j = 0, i = 2; i < crossedOut.length; i++) 
if (notCrossed (i) ) 
result[j**] = i; 


) 


private static int numberOfUncrossedIntegers() 


{ 
int count = 0; 
for (int i = 2; i < crossedOut.length; i++) 
if (notCrossed(i)) 
counttt; 


return count; 
) 
) 


很 容易 说 明 ， 第 一 个 注释 完全 是 多 余 的 ， 因 为 它 读 起 来 非常 像 是 generatePrimes 函数 自 
身 。 不 过 ， 我 认为 这 段 注 释 还 是 省 了 读者 去 读 具 体 算法 的 精力 ， 所 以 我 倾向 于 留 下 它 。 

第 二 个 注释 显然 很 有 必要 。 它 解释 了 平方 根 作为 循环 限制 的 理由 。 我 找 不 到 能 说 明白 这 
个 问题 的 简单 变量 名 或 者 其 他 编程 结构 。 另 外 ， 对 平方 根 的 使 用 可 能 也 有 点 武断 。 通 过 限制 
平方 根 循环 ， 我 是 否 真 节 省 了 许多 时 间 ? 平方 根 计 算 所 花 的 时 间 会 不 会 比 省 下 的 时 间 还 要 
多 ? 这 些 都 值得 考虑 。 使 用 平方 根 作 为 循环 限制 , 满足 了 我 这 种 旧式 C 语言 和 汇编 语言 黑客 ， 
不 过 我 可 不 敢 说 抵 得 上 其 他 人 为 理解 它 而 花 的 时 间 和 精力 。 


4.5 文献 


[KP78]: Kernighan and Plaugher, The Elements of Programming Style, 2d. ed., McGraw- Hill, 
1978; 





— 


当 有 人 碍 看 底层 代码 实现 时 ， 我 们 希望 他 们 为 其 整洁 、 一 致 及 所 感知 到 的 对 细节 的 关注 
而 震惊 。 我 们 希望 他 们 高 高 扬 起 眉毛 ， 一 路 看 下 去 。 我 们 希望 他 们 感受 到 那些 为 之 劳作 的 专 
业 人 士 们 。 但 车 他 们 看 到 的 只 是 一 堆 像 是 由 酒 醉 的 水 手写 出 的 鬼 画 符 ， 那 他 们 多 半 会 得 出 结 
论 ， 认 为 项 目 其 他 任何 部 分 也 同样 对 细 市 漠不关心 。 

你 应 该 保持 良好 的 代码 格式 。 你 应 该 选用 一 套 管理 代码 格式 的 简单 规则 ， 然 后 贯彻 这 些 - 
规则 。 如 果 你 在 团队 中 工作 ， 则 团队 应 该 一 致 同意 采用 一 套 简 单 的 格式 规则 ， 所 有 成 员 都 要 
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遵从 。 使 用 能 帮 你 应 用 这 些 格式 规则 的 自动 化 工具 会 很 有 帮助 。 


5.1 格式 的 目的 


先 明确 一 下 ,代码 格式 很 重要 。 代 码 格式 不 可 忽略 ， 必 须 严肃 对 待 。 代 码 格 式 关 平 沟通 ， 
而 沟通 是 专业 开发 者 的 头等 大 事 。 

或 许 你 认为 “让 代码 能 工作 ” 才 是 专业 开发 者 的 头等 大 事 。 然而 ， 我 希望 本 书 能 让 你 抛 
掉 那 种 想法 。 你 今天 编写 的 功能 ， 极 有 可 能 在 下 一 版 本 中 被 修改 ， 但 代码 的 可 读 性 却 会 对 以 
后 可 能 发 生 的 修改 行为 产生 深远 影响 。 原 始 代码 修改 之 后 很 入， 其 代码 风格 和 可 读 性 仍 会 影 
响 到 可 维护 性 和 扩展 性 。 即 便 代 码 已 不 复 存在 ， 你 的 风格 和 律 条 仍 存活 下 来 。 

那么 ， 哪 些 代 码 格式 相关 方面 能 帮 有 我 们 最 好 地 沟通 呢 ? 


5.2 ”垂直 格式 


从 垂直 尺寸 开始 吧 。 源 代码 文件 该 有 多 大 ? 在 Java P, 文件 尺寸 与 类 尺寸 极其 相关 ， 讨 
论 类 时 再 说 类 的 尺寸 。 现 在 先 考虑 文件 尺寸 。 
多 数 Java 源 代码 文件 有 多 大 ? 事实 说 明 ， 尺 寸 各 各 不 同 ， 长 度 殊 异 ， 如 图 5-1 所 示 。 


10000.0 E— 
1000.0 上: 


100.0 E 


每 个 文件 中 的 代码 行 数 





junit fitnesse testNG tam jdepend ant tomcat 


图 5-1 ”以 对 数 标 尺 显示 的 文件 长 度 分 布 ( 方 块 高 度 =sigma) 


图 5-1 中 涉及 7 个 不 同 项 目 ，Junit、FitNesse、testNG、Time and Money、JDepend、Ant 
和 Tomcat。 贯 穿 方块 的 直线 两 端 显示 这 些 项 目 中 最 小 和 最 大 的 文件 长 度 。 方 块 表示 在 平均 值 
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以 上 或 以 下 的 大 约 三 分 之 一 文件 (一 个 标准 偏差 ') 的 长 度 。 方 块 中 间 位 置 就 是 平均 数 。 所 以 
FitNesse 项 目的 文件 平均 尺寸 是 65 77, 而 上 面 三 分 之 一 在 40 一 100 行 及 100 行 以 上 之 间 。 
FitNesse 中 最 大 的 文件 大 约 400 行 ， 最 小 是 6 行 。 这 是 个 对 数 标尺 ， 所 以 较 小 的 垂直 位 置 差 
异 意 味 着 文件 绝对 尺寸 的 较 大 差异 。 

Junit, FitNesse 和 Time and Money 由 相对 较 小 的 文件 组 成 。 没 有 一 个 超过 500 行 ， 多 数 
都 小 于 200 行 。Tomcat 和 Ant 则 有 些 文件 达到 数 千 行 ， 将 近 一 半 文 件 长 于 200 行 。 

对 我 们 来 说 ， 这 意味 着 什么 ? 意味 着 有 可 能 用 大 多 数 为 200 行 、 最 长 500 行 的 单个 文件 
构造 出 色 的 系统 (FitNesse 总 长 约 50000 行 )。 尽 管 这 并 非 不 可 违背 的 原则 ， 也 应 该 乐于 接受 。 
短文 件 通常 比 长 文件 务 于 理解 。 


52.1 向 报纸 学 习 


想 想 看 写 得 很 好 的 报纸 文章 。 你 从 上 到 下 阅读 。 在 项 部， 你 期 望 有 个 头条 ， 告 诉 你 故事 主 
题 ， 好 让 你 决定 是 否 要 读 下 去 。 第 一 段 是 整个 故事 的 大 纲 ， 给 出 粗 线条 概述 ， 但 隐藏 了 故事 细 
节 。 接 着 读 下 去 ， 细 节 渐 次 增加 ， 直 至 你 了 解 所 有 的 日 期 、 名 字 、 引 语 、 说 法 及 其 他 细节 。 

源 文件 也 要 像 报纸 文章 那样 。 名 称 应 当 简 单 且 一 目 了 然 。 名 称 本 身 应 该 足够 告诉 我 们 是 
否 在 正确 的 模块 中 。 源 文件 最 顶部 应 该 给 出 高 层次 概念 和 算法 。 细 节 应 该 往 下 渐次 展开 ， 直 
至 找到 源 文件 中 最 确 层 的 函数 和 细节 。 | 

报纸 由 许多 篇 文章 组 成 ， 多 数 短小 精 悍 。 有 些 稍微 长 点 儿 。 很 少 有 占 满 一 整 页 的 。 这 样 
做 ， 报 纸 才 可 用 。 ~ 份 报纸 只 登载 一 篇 长 故事 ， 其 中 充斥 毫 无 组 织 的 事实 、 日 期 、 名 字 
等 ， 没 人 会 去 读 


Sec 概念 间 垂 直 万 向 上 的 区 隔 


几乎 所 有 的 代码 都 是 从 上 往 下 读 ， 从 左 往 右 读 。 每 行 展 现 一 个 表达 式 或 一 个 子 句 ， 每 组 
代码 行 展示 一 条 完整 的 思路 。 这 些 思路 用 空白 行 区 隔 开 来 。 

以 代码 清单 5-1 为 例 。 在 封包 声明 、 导 入 声明 和 每 个 函数 之 间 ， 都 有 空白 行 隔 开 。 这 条 
极其 简单 的 规则 极 大 地 影响 到 代码 的 视觉 外 观 。 每 个 空白 行 都 是 一 条 线索 ， 标 识 出 新 的 独立 
概念 。 往 下 读 代码 时 ， 你 的 目光 总 会 停留 于 空白 行 之 后 那 一 行 。 


代码 清单 5-1 BoldWidget.java 
package fitnesse.wikitext.widgets; 
import java.util.regex.*; 


| RUE: 方块 显示 平均 数 的 sigma/2 以 上 及 以 下 长 度 。 没 错 ， 我 知道 文件 长 度 分 布 不 太 寻 常 ， 所 以 标准 偏差 也 并 非 那么 精 
确 。 不 过 在 此 并 不 寻求 精确 ， 只 是 找 个 感觉 罢了 。 


M 
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public class BoldWidget extends ParentWidget { 

public static final String REGEXP = "''',42'''"; 

private static final Pattern pattern = Pattern.compile(""''(.+?)'''", 
Pattern.MULTILINE + Pattern.DOTALL | i 
); | 


| public BoldWidget (ParentWidget parent, String text) throws Exception { 
super (parent); 
Matcher match = pattern.matcher (text); 
match.find(); 5 | 
addChildWidgets (match.group(1)); 
) 


public String render() throws Exception { 
StringBuffer html = new StringBuffer ("<b>"); 
html .append (childHtml ()) .append("</b>") ; 
return html.toString(); 
) 
) 


如 代码 清单 5-2 所 示 ， 抽 掉 这 些 空白 行 ， 代码 可 读 性 减弱 了 不 少 。 


代码 清单 5-2 BoldWidget.javá 


package fitnesse.wikitext.widgets; 
import java.util.regex.*; 
public class BoldWidget extends ParentWidget ( 
public static final String REGEXP - "''',42'''"; 
private static final Pattern pattern = Pattern.compile("'''(.42)'''", 
Pattern.MULTILINE + Pattern.DOTALL) ; 
public BoldWidget(ParentWidget parent, String text) throws Exception { 
super (parent) ; 
Matcher match = pattern.matcher (text); 
match. find(); 
addChildWidgets (match.group(1));} 
public String render() throws Exception { 
StringBuffer html = new StringBuffer ("<b>") ; 
html.append(childHtml () ) ,append ("</b>"); 
return html.toString(); 
) 
} 


在 你 不 特意 注视 时 ， 后 果 就 更 严重 了 。 在 第 一 个 例子 中 ， 代 码 组 会 跳 到 你 眼中 ， 而 第 二 
MAF RA HEAL. FRAN KA, Ray BBA EERIE 


523 垂直 方向 上 的 靠近 


如 果 说 空白 行 隔 开 了 概念 ， 靠 近 的 代码 行 则 上 暗示 了 它们 之 间 的 暴 密 关 系 。 所 以 ， 紧 密 相 
关 的 代码 应 该 互相 靠近 。 注 意 代 码 清单 5-3 中 的 注释 是 如 何 制 断 两 个 实体 变量 间 的 联系 的 。 
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代码 清单 5-3 


public class ReporterConfig { 


* The class name of the reporter listener 
xf . 


private Be m className; 


/** 


* The properties of the reporter listener 
WI 
private List«Property» m properties = new ArrayList<Property>(); 


public void addProperty (Property property) ( 
m properties.add(property); 
|] 
代码 清单 5-4 更 易于 阅读 。 它 刚好 " — OR", 全 少 对 我 来 说 是 这 样 。 我 一 眼 就 能 看 到 ， 
这 是 个 有 两 个 变量 和 一 个 方法 的 类 。 看 上 面 的 代码 时 ， 我 不 得 不 更 多 地 移动 头 部 和 眼球 ， 才 
能 获得 相同 的 理解 度 。 


代码 清单 5-4 


public class ReporterConfig { 
private String m className; | 
private List«Property» m properties = new ArrayList<Property>(); 


public void addProperty(Property property) { 
m properties.add (property); 
) 


52.4 HAPS 


你 是 否 曾经 在 某 个 类 中 摸索 ， 从 一 个 函数 跳 到 另 一 个 函数 ， 上 下 求索 ， 想 要 和 弄 清楚 这 些 
函数 如 何 操 作 、 如 何 互 相 相 关 ， 最 后 却 被 搞 糊 涂 了 ? 你 是 否 曾经 苦 苦 追 索 某 个 变量 或 函数 的 
继承 链条 ? IXiL MAE, 因为 你 想 要 理解 系统 做 什 和 ， 但 却 化 时 间 和 精力 在 找到 和 记 住 那些 
代码 碎片 在 哪里 。 

关系 密切 的 概念 应 该 互相 靠近 [G10]。 显 然 , 这 条 规则 并 不 适用 于 分 布 在 不 同文 件 中 的 概 
念 。 除 非 有 很 好 的 理由 ， 否 则 就 不 要 把 关系 密切 的 概念 放 到 不 同 的 文件 中 。 实 际 上 ， 这 也 是 
避免 使 用 protected 变量 的 理由 之 一 。 

对 于 那些 关系 密切 、 放 置 于 同一 源 文件 中 的 概念 ， 它 们 之 间 的 区 隔 应 该 成 为 对 相互 的 易 
懂 度 有 多 重要 的 衡量 标准 。 应 避免 迫使 读者 在 源 文件 和 类 中 跳 来 跳 去 。 

变量 声明 。 变 量 声 明 应 尽 可 能 靠近 其 使 用 位 置 。 因 为 函数 很 短 ， AAAS VE RC 

顶部 出 现 ， 就 像 Junit4.3.1 中 这 个 稍 长 的 函数 中 那样 。 
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Private Static void peach neresencse) { 
InputStream is= null; 
try { 
is- new FileInputStream(getPreferencesFile()); 
setPreferences (new Properties (getPreferences())); 
getPreferences().load(is); 
) catch (IOException e) | 
try ( 
if (is != null) 
is.close(); 
) catch (IOException el) ( 
) 
) 
) 


循环 中 的 控制 变量 应 该 总 是 在 循环 语句 中 声明 , 如 下 列 来 自 B 目的 绝妙 小 函数 所 示 。 


public int countTestCases() { 
int count= 0; 
for (Test each : tests) 
count .+= each.countTestCases(); 
return count; 


} 


偶尔 ， 在 较 长 的 函数 中 ， 变 量 也 可 能 在 某 个 代码 块 项 部 ， 或 在 循环 之 前 声明 。 你 可 以 在 
以 下 摘自 TestNG 中 一 个 长 函数 的 代码 片段 中 找到 类 似 的 变量 。 


for (XmlTest test : m suite.getTests()) ( 
TestRunner tr - m runnerFactory.newTestRunner (this, test) ; 
tr.addListener (m textReporter); 
m testRunners.add(tr); 


invoker = tr.getInvoker(); 


for (ITestNGMethod m : tr.getBeforeSuiteMethods()) ( 
beforeSuiteMethods.put (m.getMethod(), m); 
} | | 


for (ITestNGMethod m : tr.getAfterSuiteMethods()) { 
afterSuiteMethods.put(m.getMethod(), m); 

) | 

E 


实体 变量 应 该 在 类 的 顶部 声明 。 这 应 该 不 会 增加 变量 的 垂直 距离 ， BA SW 良好 的 类 
中 ， 它 们 如 果 不 是 被 该 类 的 所 有 方法 也 是 被 大 多 数 方 法 所 用 。 i 

关于 实体 变量 应 该 放 在 哪里 , 争论 不 断 。 在 C++ 中 , 通常 会 采用 所 谓 “ 剪 刀 原 则 ”(scissors 
rule)， 所 有 实体 变量 都 放 在 底部 。 而 在 Java 中 ， 惯 例 是 放 在 类 的 顶部 。 没 理由 去 遵循 其 他 惯 
例 。 重 点 是 在 谁 都 知道 的 地 方 声明 实体 变量 。 大 家 都 应 该 知道 在 哪儿 能 看 到 这 些 声明 。 

例如 JUnit 4.3.1 中 的 这 个 奇怪 情形 。 我 极力 删 减 了 这 个 类 ， 好 说 明 问 题 。 如 果 你 看 到 代 
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码 清单 大 致 一 半 的 位 置 ， 会 看 到 在 那里 声明 了 两 个 实体 变量 。 如 果 放 在 更 好 的 位 置 ， 它 们 就 
会 更 明显 。 而 现在 ， 读 代码 者 只 能 在 无 意 中 看 到 这 些 声明 〈 就 像 我 一 样 )。 
public class TestSuite implements Test { 


Static public Test createTest(Class«? extends TestCase» theClass, 
String name) ( 


) 
public static Constructor«? extends TestCase» 


getTestConstructor(Class«? extends TestCase» theClass) 
throws NoSuchMethodException { 


) 


public static Test warning(final String message) ( 


) 


private static String exceptionToString(Throwable t) ( 


) 
private String fName; 
private Vector<Test> fTests- new Vector<Test> (10); 


public TestSuite() ( 
) 


public TestSuite(final Class<? extends TestCase> theClass) { 


} 


public TestSuite(Class«? extends TestCase> theClass, String name) { 
} 


} 


HABA. STT AST, RMAC, MHWAAMAR 
能 放 在 被 调用 者 上 面 。 这 样 ， 程 序 就 有 个 自然 的 顺序 。 若 坚定 地 遵循 这 条 约定 ， 读 者 将 能 够 
确信 函数 声明 总 会 在 其 调用 后 很 快 出 现 。 以 源 自 FitNesse 的 代码 清单 5-5 为 例 。 注 意 顶 部 的 
函数 是 如 何 调用 其 下 的 函数 ， 而 这 些 被 调用 的 函数 又 是 如 何 调用 更 下 面 的 函数 的 。 这 样 就 能 
轻易 找到 被 调用 的 函数 ， 极 大 地 增强 了 整个 模块 的 可 读 性 。 


代码 清单 5-5 WikiPageResponder. java 


public class WikiPageResponder implements SecureResponder { 
protected WikiPage page; 
protected PageData pageData; 
protected String pageTitle; 
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protected Request request; 
protected PageCrawler crawler; 


public Response makeResponse (FitNesseContext context, Request BEQUEM 
throws Exception { 
String pageName = getPageNameOrDefault (request, "FrontPage") ; 
loadPage (pageName, context); 
if (page == null) 
return notFoundResponse (context, request); 
else 
return makePageResponse (context) ; 


) 


private String getPageNameOrDefault (Request request, String defaultPageName) 
( 
String pageName = request.getResource(); , 
if (StringUtil.isBlank(pageName)) 
pageName = defaultPageName; 
return pageName; 


) 


protected void loadPage(String resource, FitNesseContext context) 
throws Exception ( 
WikiPagePath path = PathParser.parse(resource); 
crawler = context.root.getPageCrawler(); 
crawler.setDeadEndStrategy (new VirtualEnabledPageCrawler()); 
page = crawler.getPage(context.root, path); 
if (page != null) 

pageData = page.getData(); 
) 


private Response notFoundResponse(FitNesseContext context, Request request) 
throws Exception { 
return new NotFoundResponder().makeReésponse(context, request); 


) 


private SimpleResponse makePageResponse (FitNesseContext context) 
throws Exception { 
pageTitle = PathParser.render(crawler.getFullPath (page) ); 
String html = makeHtml (context); 


SimpleResponse response = new SimpleResponse(); 
response.setMaxAge (0) ; 
response.setContent (html); 

return response; 


说 句 题 外 话 , 以 上 代码 片段 也 是 把 常量 保持 在 恰当 级 别 的 
好 例子 [G35]。FrontPage 常量 可 以 埋 在 getPageNameOrDefault 
图 数 中 , 但 那样 就 会 把 一 个 众人 皆 知 的 常量 埋藏 到 位 于 不 太 . 
合适 的 底层 函数 中 。 更 好 的 做 法 是 把 VOIE T SERIA 
置 ， 然 后 再 传 递 到 真实 使 用 的 位 置 。 
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概念 相关 。 概 念 相 关 的 代码 应 该 放 到 一 起 。 相 关 性 越 强 ， 彼 此 之 间 的 距离 就 该 越 短 。 

如 上 所 述 ， 相 关 性 应 建立 在 直接 依赖 的 基础 上 ， 如 函数 间 调 用 ， 或 函数 使 用 某 个 变量 。 
但 也 有 其 他 相关 性 的 可 能 。 相 关 性 可 能 来 自 于 执行 相似 操作 的 一 组 函数 。 请 看 以 下 来 自 Junit 
4.3.1 的 代码 片段 : 


public class Assert ( 

static public void assertTrue(String message, boolean condition) { 
if (!condition) 

fail (message); 


) 


static public void assertTrue(boolean condition) { 
assertTrue(null, condition); 


) 


Static public void assertFalse(String message, boolean condition) { 
assertTrue (message, !condition); 


) 


. Static public void assertFalse(boolean condition) { 
assertFalse(null, condition); 
) 


这 些 函 数 有 着 极 强 的 概念 相关 性 ， 因 为 他 们 拥有 共同 的 命名 模式 ， 执 行 同一 2 
不 同 变种 。 互 相 调用 是 第 二 位 的 。 即 便 没 有 互相 调用 ， 也 应 该 放 在 一 起 。 
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一 般 而 言 ， 我 们 想 自 上 向 下 展示 函数 调用 依赖 顺序 。 也 就 是 说 ， 被 调用 的 函数 应 该 放 在 
执行 调用 的 函数 下 面 '。 这 样 就 建立 了 一 种 自 顶 向 下 贯穿 源 代码 模块 的 良好 信息 流 。 

像 报 纸 文章 一 般 , 我 们 指望 最 重要 的 概念 先 出 来 , 指望 以 包括 最 少 细节 的 方式 表述 它们 。 
我 们 指望 底层 细节 最 后 出 来 。 这 样 ， 我 们 就 能 扫 过 源 代码 文件 ， 自 最 前 面 的 几 个 函数 获知 要 
虽 ， 而 不 至 于 沉溺 到 细节 中 。 代 码 清单 5-5 就 是 如 此 组 织 的 。 或 许 ， 更 好 的 例子 是 代码 清单 
15-5， 及 代码 清单 3-7。 


9.9. Sg 


一 行 代码 应 该 有 多 宽 ? 要 回答 这 个 问题 ， 来 看 看 典型 的 程序 中 代码 行 的 宽度 。 我 们 再 一 次 检 
验 7 个 不 同 项 目 。 图 5-2 展示 了 这 7 个 项 目的 代码 行 宽度 分 布 情况 。 其 中 展现 的 规律 性 令 人 印象 


' RYE: Pascal, CH C++ 等 语言 中 完全 不 同 ， 在 这 些 语言 中 ， 函 数 应 该 在 被 调用 之 前 定义 ， 至 少 是 声明 。 
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深刻 ，45 个 字符 左右 的 宽度 分 布 尤为 如 此 。 其 实 ，20 一 60 的 每 个 尺寸 ， 都 代表 全 部 代码 行 数 的 
1%。 也 就 是 总 共 40%! 或 许 其 余 30% 的 代码 行 短 于 10 个 字符 。 记 住 ， 这 是 个 对 数 标尺 ， 所 以 图 
中 长 于 80 个 字符 部 分 的 线性 下 降 在 实际 情况 中 会 极其 可 观 。 程 序 员 介 ] 显 然 更 喜爱 短 代码 和 
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图 $-2 Java 程序 代码 行 长 度 分 布 


这 说 明 ， 应 该 尽力 保持 代码 行 短小 。 死 守 80 个 字符 的 上 限 有 点 僵化 ， 而 且 我 也 并 不 反对 
代码 行 长 度 达 到 100 个 字符 或 120 个 字符 。 再 多 的 话 ， 大 抵 就 是 肆意 到 为 了 。 

我 一 向 遵循 无 需 拖 动 滚动 条 到 右边 的 原则 。 但 近年 来 显示 器 越 来 越 宽 ， 而 年 轻 程 序 员 又 
能 将 显示 字符 缩小 到 如 此 程度 ， 屏 幕 上 甚至 能 容纳 200 个 字符 的 宽度 。 别 那么 做 。 我 个 人 的 
上 限 是 120 个 字符 。 


5.3.1 水 平方 向 上 的 区 隔 与 靠近 


我 们 使 用 空格 字符 将 彼此 紧密 相关 的 事物 连接 到 一 起 ， 也 用 空格 字符 把 相关 性 较 弱 的 事 
物 分 隔 开 。 请 看 以 下 函数 ， 


private void measureLine (String line) { 
lineCountt*; 
int lineSize - line.length(); 
totalChars *- lineSize; 
lineWidthHistogram.addLine(lineSize, lineCount); 
recordWidestLine (lineSize); 


} 
我 在 赋值 操作 符 周围 加 上 空格 字符 ， 以 此 达到 强调 目的 。 赋 值 语句 有 两 个 确定 而 重要 的 
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BR: 左边 和 右边 。 空 格 字符 加 强 了 分 隔 效果 。 

男 一 方面 ， 我 不 在 函数 名 和 左 圆 括 号 之 间 加 空格 。 这 是 因为 函数 与 其 参数 密切 相关 ， 如 
果 隔 开 ， 就 会 显得 互 无 关系 。 我 把 函数 调用 括号 中 的 参数 一 一 隔 开 ， 强 调 喜 号 ， 表 示 参 数 是 
互相 分 离 的 。 | 

空格 字符 的 另 一 种 用 法 是 强调 其 前 面 的 运算 符 。 


public class Quadratic { 
public static double rootl (double a, double b, double c) { 
double determinant = determinant(a, b, c); 
return (-b + Math.sqrt(determinant)) / (2*a); 
} . 
public static double root2(int a, int b, int c) ( 
double determinant = determinant(a, b, c); 
return (-b - Math.sqrt(determinant)) / (2*a); 
) e 


private static double determinant (double a, double b, double c) ( 
return b*b - 4*a*c; 
) 
} 


看 看 这 些 等 式 读 起 来 多 舒服 。 乘 法 因子 之 间 没 加 空格 ， 因 为 它们 具有 较 高 优先 级 。 加 减 
法 运算 项 之 间 用 空格 隔 开 ， 因 为 加 法 和 减法 优先 级 较 低 。 | 

不 笠 的 是 ,多 数 代 码 格式 化 工具 都 会 漠视 运算 符 优 先 级 ， 从 头 到 尾 采 用 同样 的 空格 方式 。 
在 重新 格式 化 代码 后 ， 以 上 这 些微 妙 的 空格 用 法 就 消失 殉 尽 了 。 


53.2 水平 对 章 


当 我 还 是 个 汇编 语言 程序 员 时 !， 使 用 水 平 对 齐 来 强调 某 些 程序 结构 。 开 始 用 C、C+ 编 
码 ， 最 终 转 向 va 后 ， 我 级 续 尽力 对 齐 一 组 声明 中 的 变量 名 ， 或 一 组 赋 信 滞 和 中 的 右 信 。 3 
的 代码 看 起 来 大 概 是 这 样 


public class FitNesseExpediter implements ResponseSender 


{ 


private Socket socket; . 

private InputStream input; 

private OutputStream output; 

private Request request; 

private Response response; 

private FitNesseContext context; 

protected long requestParsingTimeLimit; 
private long requestProgress; 

private long requestParsingDeadline; 
private boolean hasError; 


| RÈ: 开 什 么 玩笑 ! 到 现在 我 仍 是 个 汇编 语言 程序 员 。 把 男孩 从 铁 旁边 赶 走 容易 ， 从 男孩 身边 把 铁 拿 走 可 难 ! 
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public FitNesseExpediter (Socket © S, 
FitNesseContext context) Dëse Exception 


{ 


this.context = context; 

Socket - S; 

input - s.getInputStream(); 
output = ` S. UD MD E 


requestParsingTimeLimit - 10000; 
) 


我 发 现 这 种 对 齐 方式 没什么 用 。 对 齐 ， 像 是 在 强调 不 重要 的 东西 ， 把 我 的 目光 从 真正 的 
意义 上 拉 开 。 例如， 在 上 面 的 声明 列表 中 ， 你 会 从 上 到 下 阅读 变量 名 ， 而 忽视 了 它们 的 类 型 。 
同样 ， 在 赋值 语句 代码 清单 中 ， 你 也 会 从 上 到 下 阅读 右 值 ， 而 对 赋值 运算 符 视 而 不 见 。 更 麻 
烦 的 是 ， 代 码 自动 格式 化 工具 通常 会 把 这 类 对 齐 消除 掉 。 

所 以 ， 我 最 终 放 弃 了 这 种 做 法 。 如 今 ， 我 更 喜欢 用 不 对 齐 的 声明 和 赋值 ， 如 下 所 示 ， 因 
为 它们 指出 了 重点 。 如 果 有 较 长 的 列表 需要 做 对 齐 处 理 ， 那 问题 就 是 在 列表 的 长 度 上 而 不 是 
对 齐 上 。 下 例 FitNesseExpediter 类 中 声明 列表 的 长 度 说 明 该 类 应 该 被 拆 分 了 。 | 


public class FitNesseExpediter implements ResponseSender 
{ — 
private Socket socket; 
private InputStream input; 
private OutputStream output; 
private Request request; 
private Response response; 
private FitNesseContext context; 
protected long requestParsingTimeLimit; 
private long requestProgress; 
private long requestParsingDeadline; 
private boolean hasError; 


public FitNesseExpediter (Socket s, FitNesseContext context) throws Exception 


{ 
this.context = context; 
socket = s; 
input = s.getInputStream(); 
output = s.getOutputStream(); 
requestParsingTimeLimit = 10000; 


} 
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源 文件 是 一 种 继承 结构 ， 而 不 是 一 种 大 纲 结构 。 其 中 的 信息 涉及 整个 文件 、 文 件 中 每 个 
类 、 类 中 的 方法 、 方 法 中 的 代码 块 ， 也 涉及 代码 块 中 的 代码 块 。 这 种 继承 结构 中 的 每 一 层级 
都 圈 出 一 个 范围 ， 名 称 可 以 在 其 中 声明 ， 而 声明 和 执行 语句 也 可 以 在 其 中 解释 。 

要 让 这 种 范围 式 继承 结构 可 见 ， 我 们 依 源 代码 行 在 继承 结构 中 的 位 置 对 源 代 码 行 做 缩 进 
处 理 。 在 文件 顶层 的 语句 ， 例 如 大 多 数 的 类 声明 ， 根 本 不 缩 进 。 类 中 的 方法 相对 该 类 缩 进 一 
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个 层级 。 方 法 的 实现 相对 方法 声明 缩 进 一 个 层级 。 代 码 块 的 实现 相对 于 其 容器 代码 块 缩 进 一 
个 层级 ， 以 此 类 推 。 
程序 员 相 当 依 赖 这 种 缩 进 模式 。 他 们 从 代码 行 左边 查看 自己 在 什么 范围 中 工作 。 这 让 他 
们 能 快速 跳 过 与 当前 关注 的 情形 无 关 的 范围 ， 例 如 让 或 while 语句 的 实现 之 类 。 他 们 的 眼光 
扫 过 左边 ， 查 找 新 的 方法 声明 、 新 变量 ， 甚 至 新 类 。 没 有 缩 进 的 话 ， 程 序 就 会 变 得 无 法 阅读 。 
试看 以 下 在 语法 和 语义 上 等 价 的 两 个 程序 ， 


public class FitNesseServer implements SocketServer { private FitNesseContext 
context; public FitNesseServer(FitNesseContext context) { this.context = 
context; ) public void serve(Socket s) ( serve(s, 10000); } public void 
serve(Socket s, long requestTimeout) ( try ( FitNesseExpediter sender - new. 
FitNesseExpediter(s, context); 

sender.setRequestParsingTimeLimit (requestTimeout); sender.start(); } 
catch(Exception e) ( e.printStackTrace(); ) } ) 


public class FitNesseServer implements SocketServer { 
private FitNesseContext context; 
public FitNesseServer (FitNesseContext context) ( 
this.context = context; 


) 


public void serve(Socket s) ( 
serve(s, 10000); 
) 


public void serve(Socket s, long requestTimeout) { 
try { 
FitNesseExpediter sender = new FitNesseExpediter(s, context); 
sender. setRequestParsingTimeLimit (requestTimeout); 
sender.start(); 
i 
catch (Exception e) { 
e.printStackTrace(); 
} i 
} 
) 


你 能 很 快 地 洞悉 有 缩 进 的 那个 文件 的 结构 。 你 几乎 能 立即 就 辨别 出 那些 变量 、 构 造 器 、 
存 取 器 和 方法 。 只 需要 几 秒 钟 就 能 了 解 这 是 一 个 套 接 字 的 简单 前 端 ， 其 中 包括 了 超时 设 定 。 
而 未 缩 进 的 版 本 则 不 经 过 一 番 折 腾 就 无 法 明白 。 

违反 缩 进 规则 。 有 时 ， 会 忍 不 住 想 要 在 短小 的 if 语句 、 while faa heb EE 
规则 。 一 旦 这 人 么 做 了 ， 我 多 数 时 候 还 是 会 回头 加 上 缩 进 。 这 样 就 避免 了 出 现 以 下 这 种 范围 层 
级 南 塌 到 一 行 的 情况 ; 

public class CommentWidget extends TextWidget 


( 
public static final String REGEXP = "*#[*\r\n]*(?:(?:\r\n) | An] Nc) ?"; 
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public GO parent， String text) (super (parent, text);} ` 
public String render () throws Exception (return ""; ) 


) 
我 更 喜欢 扩展 和 缩 进 范围 ， 就 像 这 样 : 


public class CommentWidget extends TextWidget { 
public static final String REGEXP = "*#[* \r\n] * (?: (?: \r\n) INnlNr) 2"; 


public CommentWidget (ParentWidget parent, String text) { 
_ Super (parent, text); 
) | 
public String render() throws Exception ( 
return ""; 
) 
) 


53.4 ZE 


有 时 ，while 或 for 语句 的 语句 体 为 室 ， 如 下 所 示 。 我 不 喜欢 这 种 结构 ， 尽 量 不 使 用 。 如 
果 无 法 避免 ， 就 确保 空 范围 体 的 缩 进 ， 用 括号 包围 起 来 。 我 无 法 告诉 你 ， 我 曾经 多 少 次 被 静 
静安 坐 在 与 while 循环 语句 同一 行 末尾 的 分 号 所 欺骗 。 除 非 你 把 那个 分 号 放 到 另 一 行 再 加 以 
缩 进 ， 否 则 就 很 难看 到 它 。 


while (dis.read(buf, 0, readBufferSize) != -1) 


£ 


9.4 团队 规则 


每 个 程序 员 都 有 自己 喜欢 的 格式 规则 ， 但 如 果 在 一 个 团队 中 工作 ， 就 是 团队 说 了 算 。 

一 组 开发 者 应 当 认 同一 种 格式 风格 ， 每 个 成 

员 都 应 该 采用 那 种 风格 。 我 们 想 要 让 软件 拥有 一 

以 贯 之 的 风格 。 我 们 不 想 让 它 显 得 是 由 一 大 票 意 
见 相 左 的 个 人 所 写成 。 

2002 年 启动 FitNesse 项 目 时 ， 我 和 开发 团队 

一 起 制订 了 一 套 编 码 风 格 。 这 只 花 了 我 们 10 分 钟 

时 间 。 我 们 决定 了 在 什么 地 方 放 置 括号 ， 缩 进 几 

个 字符 ， 如 何 命名 类 、 变 量 和 方法 ， 如 此 等 等 。 





!' 译注 : 团队 规则 ， 原 文 team rules。 单 词 role 在 这 里 有 两 个 意思 ， 一 个 是 名 词 “规则 ”， 一 个 是 动词 “管辖 ” 所 以 本 节 
标题 玩 了 个 文字 游戏 。 中 文 不 易 翻 出 ， 故 采取 意译 加 注 。 
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然后 ， 我 们 把 这 些 规则 编写 进 IDE 的 代码 格式 功能 ， 接 着 就 一 直 沿 用 。 这 些 规则 并 非 全 是 我 
喜爱 的 ;但 它们 是 团队 决定 了 的 规则 。 作 为 团队 一 员 ， 在 为 FitNesse 项 目 编写 代码 时 ， 我 遵 
循 这 些 规则 。 | 

记 住 ， 好 的 软件 系统 是 由 一 系列 读 起 来 不 错 的 代码 文件 组 成 的 。 它 们 需要 拥有 一 致 和 顺 
畅 的 风格 。 读 者 要 能 确信 ， 他 们 在 一 个 源 文件 中 看 到 的 格式 风格 在 其 他 文件 中 也 是 同样 的 用 
法 。 绝 对 不 要 用 各 种 不 同 的 风格 来 编写 源 代码 ， 这 样 会 增加 其 复杂 度 。 


5.5“ 鲍 勃 大 叔 的 格式 规则 


我 个 人 使 用 的 规则 相当 简单 ， 如 代码 清单 5.6 所 示 。 可 以 把 这 段 代码 看 作 是 展示 如 何 把 
代码 写成 最 好 的 编码 标准 文档 的 范例 。 


代码 清单 5-6 CodeAnalyzer.java 


public class CodeAnalyzer implements JavaFileAnalysis ( 
private int lineCount; 
private int maxLineWidth; 
private int widestLineNumber; 
private LineWidthHistogram EE EE 
private int totalChars; 


public CodeAnalyzer() ( 
lineWidthHistogram = new LineWidthHistogram(); 


) 


public static List<File> findJavaFiles(File parentDirectory) { 
List«File» files = new ArrayList«File»(); 
findJavaFiles(parentDirectory, files); 
return files; 


) 


private static void findJavaFiles(File parentDirectory, List<File> files) { 
for (File file : parentDirectory.listFiles()) { 
if (file.getName().endsWith(".java")) 
files.add(file); 
else if (file.isDirectory()) 
findJavaFiles(file, files); 
) 
) 


public void analyzeFile(File javaFile) throws Exception { 
BufferedReader br = new BufferedReader (new FileReader(javaFile)); 
String line;: 
while ((line = br.readLine()) != null) 
measureLine (line); 


) 


private void measureLine(String line) ( 
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lineCount++; 

int lineSize = line.length(); 

totalChars += lineSize; 
lineWidthHistogram.addLine(lineSize, lineCount) ; 
recordWidestLine (lineSize) ; 


E 


private void recordWidestLine(int lineSize) ( 
if (lineSize » maxLineWidth) ( 
maxLineWidth = lineSize; 
widestLineNumber = lineCount; 
) 
} 


public int getLineCount() { | 
return lineCount; sg | Sp mm 


public int getMaxLineWidth() ( 
return maxLineWidth; 


) 


public int getWidestLineNumber() { 
return widestLineNumber; 


) 


public LineWidthHistogram getLineWidthHistogram() { 
return lineWidthHistogram; 


) 


public double getMeanLineWidth() ( 
return (double) totalChars / lineCount; 


) 


public int getMedianLineWidth() ( 

Integer[] sortedWidths = getSortedWidths(); 

int cumulativeLineCount = 0; 

for (int width : sortedWidths) ( ` 
cumulativeLineCount += lineCountForWidth (width); 
if (cumulativeLineCount » lineCount / 2) 

return width; 
) 


throw new Error("Cannot get here"); 


2 


private int lineCountForWidth(int width) ( 
return lineWidthHistogram.getLinesforWidth (width) .size(); 
) 
private Integer[] getSortedWidths() ( 
Set<Integer> widths = lineWidthHistogram.getWidths(); 
Integer[] sortedWidths = (widths.toArray(new Integer[0])); 
Arrays.sort(sortedWidths); 
return sortedWidths; 


} 3 
j = 





心血 来 潮 时 能 目 由 修改 其 类 型 或 实现。 那么， 为 什么 还 是 有 那么 多 程序 员 给 对 象 自动 添加 赋 
值 器 和 取 值 器 ， 将 私有 变量 公之于众 、 如 同 它们 根本 就 是 公共 变量 一 般 呢 ? | 


6.1 数据 抽象 


看 看 代码 清单 6-1 和 代码 清单 6-2 之 间 的 区 别 。 每 段 代码 都 表示 箔 卡 儿 平面 上 的 一 个 点 。 
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不 过 ， 其 中 之 一 曝露 了 其 实现 ， 而 另 一 个 则 完全 隐藏 了 其 实现 。 
代码 清单 6-1 BRA 


public class Point { 
public double x; 

. public double y; 

) m 


代码 清单 6-2 ”抽象 点 


public interface Point { 
double getX(); 
double getY(); 
void du A iM LEM x, double y); 
double getR(); 
double getTheta(); 
void setPolar(double r, double theta); 


} 

代码 清单 6-2 的 漂亮 之 处 在 于 , 你 不 知道 该 实现 会 是 在 矩形 坐标 系 中 还 是 在 极 坐标 系 中 。 
可 能 两 个 都 不 是 ! 然而 ， 该 接口 还 是 明白 无 误 地 呈现 了 一 种 数据 结构 。 

不 过 它 呈 现 的 还 不 止 是 一 个 数据 结构 。 那 些 方法 固定 了 一 套 存 取 策 略 。 你 可 以 单独 读 取 
某 个 坐标 ， 但 必须 通过 一 次 原子 操作 设 定 所 有 坐标 。 

而 代码 清单 6-1 则 非常 清楚 地 是 在 矩形 坐标 系 中 实现 ， 并 要 求 我 们 单个 操作 那些 坐标 。 
这 就 曝露 了 实现 。 实 际 上 ， 即 便 变 量 都 是 私有 ， 而 且 我 们 也 通过 变量 取 值 器 和 赋值 器 使 用 变 
量 ， 其 实现 仍然 曝露 了 。 

隐藏 实现 并 非 只 是 在 变量 之 间 放 上 一 个 函数 层 那么 简单 。 隐 藏 实现 关乎 抽象 ! 类 并 不 简 
单 地 用 取 值 器 和 赋值 器 将 其 变量 推 向 外 间 ， 而 是 曝露 抽象 接口 ， MERRER TI RSR 
现 就 能 操作 数据 本 体 。 

看 看 代码 清单 6-3 和 代码 清单 6-4。 前 者 使 用 具象 手段 与 机 动车 的 燃料 层 通 信 ， 而 后 者 则 
采用 百分比 抽象 。 你 能 确定 前 者 里 面 都 是 些 变量 存 取 器 ， 而 却 无 法 得 知 后 者 中 的 数据 形态 。 


代码 清单 6-3 ”具象 机 动车 

public interface Vehicle { 
double getFuelTankCapacityInGallons(); 
double getGallonsOfGasoline(); 

) 


代码 清单 6-4 ”抽象 机 动车 


public interface Vehicle ( 
double getPercentFuelRemaining(); 
) 


以 上 两 段 代码 以 后 者 为 佳 。 我 们 不 愿 曝露 数据 细节 ， 更 愿意 以 抽象 形态 表述 数据 。 这 并 
不 只 是 用 接口 和 /或 赋值 器 、 取 值 器 就 万 事 大 吉 。 要 以 最 好 的 方式 呈现 某 个 对 象 包 含 的 数据 ， 
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需要 做 严肃 的 思考 。 傻 乐 着 乱 加 取 值 器 和 赋值 器 ， 是 最 坏 的 选择 。 


6.2 数据、 对象 的 反对 称 性 


这 两 个 例子 展示 了 对 象 与 数据 结构 之 闻 的 差异 。 对 象 把 数据 隐藏 于 抽象 之 后 ， 曝 露 操作 
数据 的 函数 。 数 据 结 构 曝 露 其 数据 ， 没 有 提供 有 意义 的 函数 。 回 过 头 再 读 一 遍 。 留 意 这 两 种 
定义 的 本 质 。 它 们 是 对 立 的 。 这 种 差异 貌似 微小 ， 但 却 有 深远 的 含义 。 | 
例如 ， 代 码 清单 6-5 中 的 过 程式 代码 形状 范例 。Geometry 类 操作 三 个 形状 类 。 形 状 类 都 
是 简单 的 数据 结构 ， 没 有 任何 行为 。 所 有 行为 都 在 Geometry 类 中 。 


代码 清单 6-5 ”过 程式 形状 代码 

public class Square ( 
public Point topLeft; 
public double side; 

) 


public class Rectangle ( 
public Point topLeft; 
public double height; 
public double width; 

) 


public class Circle { 
public Point center; 
public double radius; 


) 


public class Geometry { 
public final double PI = 3.141592653589793; 


public double; area (Object shape) throws NoSuchShapeException 

( 
if (shape instanceof Square) ( 

Square s - (Square)shape; 

pe return s.side * s.side; 

E" else if (shape instanceof Rectangle) { 
Rectangle r = (Rectangle) shape; 
return r.height * r.width; 

) 
e else if (shape instanceof Circle) ( 
E Circle c =. (Circle) shape; 
return PI * c.radius * c.radius; 

T 

throw new NoSuchShapeException(); 


ARED e p 
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面向 对 象 程序 员 可 能 会 对 此 咯 之 以 鼻 ， 抱 怨 说 这 是 过 程式 代码 一 一 他 们 大 概 是 对 的 ， 不 
过 这 种 嘲笑 并 不 完全 正确 。 想 想 看 ， 如 果 给 Geometry 类 添加 一 个 primeter( ) 函 数 会 怎样 。 屠 
些 形状 类 根本 不 会 因此 而 受 影响 ! 另 一 方面 ， 如 果 添 加 一 个 新 形状 ， 就 得 修改 Geometry 中 的 
所 有 函数 来 处 理 它 。 再 读 一 遍 代码 。 注 意 ， 这 两 种 情形 也 是 直接 对 立 的 。 

现在 来 看 看 代码 清单 6-6 中 的 面向 对 象 方案 。 这 里 ，area( ) 方 法 是 多 态 的 。 不 需要 有 
Geometry 类 。 所 以 ， 如 果 添 加 一 个 新 形状 ， 现 有 的 函数 一 个 也 不 会 受到 影响 而 当 添 加 新 函 
数 时 所 有 的 形状 都 得 做 修改 1 | 


代码 清单 6-6 ”多 态 式 形状 

public class Square implements Shape { 
private Point topLeft; 
private double side; 


public double area() { 
return side*side; 
) 
) 


public class Rectangle implements Shape { 
private Point topLeft; 
private double height; 
private double width; 


public double area() { 
return height * width; 
) 
) 


public class Circle implements Shape { 
private Point center; 
private double radius; 
public final double PI = 3.141592653589793; 


public double area() ( 
return PI * radius * radius; 
} 
} 


我 们 再 次 看 到 这 两 种 定义 的 本 质 ， 它 们 是 截然 对 立 的 。 这 说 明了 对 象 与 数据 结构 之 间 的 
二 分 原理 ; | 

过 程式 代码 (使 用 数据 结构 的 代码 ) RTF ERA BUR BEY BAR F RAs BA, 
HY RRB WE PCS BEC] BIH T RHR. | 

反 过 来 讲 也 说 得 通 ， | 

HU SANA XS np EH, 18 20 O6 ARMOR CUR VRAC. FIRST RANA A mE A 


' 原 注 : 经 验 丰 富 的 面向 对 象 设计 人 员 都 知道 一 些 方法 ,例如 ，VISITOR 模式 ,或 双 同 分 派 。 但 这 些 技法 也 有 成 本 ， 而 且 
通常 返回 一 种 过 程式 程序 的 结构 。 


6.3 得 墨 武 耳 律 o 


” 数 ， 因 为 必须 修改 所 有 类 ， 
| 所 以 ， 对 于 面向 对 象 较 难 的 事 ， 对 于 过 程式 代码 却 较 容易 ， 反 之 亦 然 
| 在 任何 一 个 复杂 系统 中 ， 都 会 有 需要 添加 新 数据 类 型 而 不 是 新 函数 的 时 候 。 这 时 ， 对 象 
E em 。 为 一 方面 ， RSS DS 是 数据 类 型 的 时 候 。 在 这 种 
情况 下 ， 过 程式 代码 和 数据 结构 更 合适 


bs FERH 





pus BEAVER CThe Law of Demeter) "iA, 模块 不 应 了 解 它 所 操作 对 象 的 内 部 情 
:有形 。 如 上 节 所 见 ， 对 象 隐藏 数据 ， 桌 圳 操作 。 这 意味 着 对 象 不 应 通过 存 取 器 奔 韦 其 内 部 结构 ， 
:因为 这 样 更 像 是 只 圳 而 非 隐 基 其 内 部 结构 。 

更 准确 地 说 ， 得 墨 忒 耳 律 认为 ， 类 C 的 方法 f 只 应 该 调用 以 下 对 象 的 方法 : 


: e 由 ff 创建 的 对 象 ; 
e ”作为 参数 传递 给 f 的 对 象 ， 
” 9 由 C 的 实体 变量 持 有 的 对 象 。 


方法 不 应 调用 由 任何 函数 返回 的 对 象 的 方法 。 换言之 ,只 跟 朋友 谈话 , 不 与 陌生 人 谈话 。 
下 列 代码 “违反 了 得 墨 忒 耳 律 (除了 违反 其 他 规则 之 外 )， 因 为 它 调用 了 getOptions( ) 返 回 
mn getScratchDir( ) 函 数 ， 又 调用 了 getScratchDir( ) 返 回 值 的 getAbsolutePath( ) 方 法 。 


final String outputDir = ctxt.getOptions().getScratchDir().getAbsolutePath(); 


火车 失事 
,这 类 代码 常 被 称 作 火 车 失事 ， 因 为 它 看 起 来 就 像 是 一 列 火车 。 这 类 连 串 的 调用 通常 被 认 









:Options opts = ctxt.getOptions(); 
ile scratchDir = opts.getScratchDir(); 
inal String outputDir = scratchDir. dore penne 


- 列 代 码 是 否 违反 了 得 墨 忒 耳 律 呢 ? 当然 ， 
Hid ctxt 对 象 包含 有 多 个 选项 ， 每 个 选项 中 
一 个 临时 目录 ， 而 每 个 临时 目录 都 有 一 个 绝 


ttp:;//en.wikipedia.org/wiki//Law of Demeter. 
来 自 Apache 框架 中 某 处 。 
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XT BRB. 对 于 一 个 函数 ， 这 些 知 识 真 够 丰富 的 。 调 用 函数 懂得 如 何在 一 大 堆 不 同 对 象 间 浏览 ， 
这 些 代码 是 否 违反 得 墨 忒 耳 律 , 取决 于 ctxt, Options 和 ScratchDir 是 对 象 还 是 数据 结构 。 
如 果 是 对 象 ， 则 它们 的 内 部 结构 应 当 隐 藏 而 不 曝露 ， 而 有 关 其 内 部 细节 的 知识 就 明显 违反 了 
BRAHE., WE ctxt. Options 和 ScratchDir 只 是 数据 结构 ， 没 有 任何 行为 ， 则 它们 自然 会 
曝露 其 内 部 结构 ， 得 墨 起 耳 律 也 就 不 适用 了 。 
属性 访问 器 函数 的 使 用 把 问题 搞 复 杂 了 。 tPA, BUT RE AE 
对 得 墨 武 耳 律 的 违反 。 


final String outputDir = ctxt.options.scratchDir.absolutePath; 


如 果 数 据 结构 只 简单 地 拥有 公共 变量 ， 没 有 函数 ， 而 对 象 则 拥有 私有 变量 和 公共 函数 ， 
这 个 问题 就 不 那么 混淆 。 然 而 ， 有 些 框架 和 标准 甚至 要 求 最 简单 的 数据 结构 都 要 有 访问 器 和 
改 值 器 。 


这 种 混淆 有 时 会 不 幸 导 致 混合 结构 ， 一 半 是 对 象 ， 一 半 是 数据 结构 。 这 种 结构 拥有 执行 
操作 的 函数 ， 也 有 公共 变量 或 公共 访问 器 及 改 值 器 。 无 论 出 于 怎样 的 初衷 ， 公 共 访 问 器 及 改 
值 器 都 把 私有 变量 公开 化 ， 诱 导 外 部 函数 以 过 程式 程序 使 用 数据 结构 的 方式 使 用 这 些 变量 。 

此 类 混杂 增加 了 添加 新 函数 的 难度 ， 也 增加 了 添加 新 数据 结构 的 难度 ， 两 面 不 讨好 。 应 
避免 创造 这 种 结构 。 它 们 的 出 现 ， 展 示 了 一 种 乱七八糟 的 设计 ， 
糕 ， 完 全 无 视 一 一 他 们 是 否 需要 函数 或 类 型 的 保护 。 


6.3.3 隐藏 结构 


RIE ctxt, Options 和 ScratchDir 是 拥有 真实 行为 的 对 象 又 怎样 呢 ? 由 于 对 象 应 隐藏 其 内 
部 结构 ， 我 们 就 不 该 能 够 看 到 内 部 结构 。 这 样 一 来 ， 如 何 才能 取得 临时 目录 的 绝对 路 径 呢 ? 

ctxt.getAbsolutePathOfScratchDirectoryOption (); 

或 者 

ctx.getScratchDirectoryOption() .getAbsolutePath () 

第 一 种 方案 可 能 导致 ctxt 对 象 中 方法 的 曝露 。 第 二 种 方案 是 在 假设 getScratchDirectoryOption() 
返回 一 个 数据 结构 而 非 对 象 。 两 种 方案 感觉 都 不 好 。 

如 果 ctxt 是 个 对 象 ， 就 应 该 要 求 它 做 点 什么 ， 不 该 要 求 它 给 出 内 部 情形 。 那 我 们 为 何 还 要 








' 原 注 : 在 Refactoring: Improving the Design of Existing Code (中 译 版 《 重 构 改 善 既 有 代码 的 设计 CRICK) 一 书 中 ， 
有 时 把 这 种 情况 称 作 特性 依恋 (Feature Envy). 
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得 到 临时 目录 的 绝对 路 径 呢 ? 我 们 要 它 做 什么 ? 来 看 看 同一 模块 〈 许 多 行 之 后 ) 的 这 段 代 码 : 


String outFile = outputDir + "/" + className.replace('.', .'/') + ".class"; 
FileOutputStream fout = new FileOutputStream(outFile); 
BufferedOutputStream bos = new BufferedOutputStream(fout); 


”这 种 不 同 层级 细节 的 混杂 〈[G34][G36]) AAR. AA. DHT. SCP ESA File 对 
” 象 不 该 如 此 随便 地 混杂 到 一 起 。 不 过 ， 撒 开 这 些 毛病 ， 我 们 发 现 ， 取 得 临时 目录 绝对 路 径 的 


“初衷 是 为 了 创建 指定 名 称 的 临时 文件 。 
所 以 ， 直 接 让 ctxt 对 象 来 做 这 事 如 何 ? 


BufferedOutputStream bos = ctxt.createScratchFileStream(classFileName); 
` 这 下 看 起 来 像 是 个 对 象 做 的 事 了 ! ctxt 隐藏 了 其 内 部 结构 ， 防 止 当前 函数 因 浏览 它 不 该 
C 知道 的 对 象 而 违反 得 墨 忒 耳 律 。 | | 


6.4 ”数据 传送 对 象 


”最 为 精练 的 数据 结构 ， 是 一 个 只 有 公共 变量 、 没 有 函数 的 类 。 这 种 数据 结构 有 时 被 称 为 
数据 传送 对 象 ， 或 DTO (Data Transfer Objects). DIO 是 非常 有 用 的 结构 ， 尤 其 是 在 与 数据 
: 库 通 信 、 或 解析 套 接 字 传递 的 消息 之 类 场景 中 。 在 应 用 程序 代码 里 一 系列 将 原始 数据 转换 为 


数据 库 的 翻译 过 程 中 ， 它 们 往往 是 排头 兵 。 
更 常见 的 是 如 代码 清单 6-7 所 示 的 “ 豆 ”(bean) 结构 。 豆 结构 拥有 由 赋值 器 和 取 值 器 操作 


的 私有 变量 。 对 豆 结构 的 半 封 装 会 让 某 些 OO 纯化 论 者 感觉 舒服 些 ， 不 过 通常 没有 其 他 好 处 ， 


代码 清单 6-7 address java 


public class Address ( 
private String street; 
private String streetExtra; 
private String city; 
private String state; 
private String zip; 


meega "9 i 
d di DEC Ep AC eeh: AI Ké 7 
y (Ge jdn e. rtl, Vs 
A 
MES / ` 


public Address (String street, String streetExtra, 
String city, String state, String zip) ( 
this.street - street; 
this.streetExtra = streetExtra; 
this.city = city; 
this.state = state; 
this.zip = zip; 
) 





i: public String getStreet() { 
return street; 


) 
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public String getStreetExtra() ( 
return streetExtra; 


- 


public String getCity() ( 
"| return city; 


) 


public String getState() { 
return state; 


) 


public String getZip() ( 
return zip; 

) | 

) 





Active Record 


Active Record 是 一 种 特殊 的 DTO 形式 。 它 们 是 拥有 公共 (或 可 豆 式 访 问 的 ) 变量 的 数 E 
据 结构 , 但 通常 也 会 拥有 类 似 save 和 find 这 样 的 可 浏览 方法 。Active Record 一 般 是 对 数据 库 ` 
表 或 其 他 数据 源 的 直接 翻译 。 | | 

我 们 不 幸 经 常 发 现 开发 者 往 这 类 数据 结构 中 塞 进 业 务 规则 方法 ， 把 这 类 数据 结构 当成 对 
象 来 用 。 这 是 不 智 的 行为 ， 因 为 它 导 致 了 数据 结构 和 对 象 的 混杂 体 。 | ` 

当然 ， 解 决 方案 就 是 把 Active Record 当做 数据 结构 ， 并 创建 包含 业务 规则 、 隐 藏 内 部 数 
据 《〈 可 能 就 是 Active Record 的 实体 ) 的 独立 对 象 。 


6.5 Aë 


对 象 曝露 行为 ， 隐 藏 数据 。 便 于 添加 新 对 象 类 型 而 无 需 修改 既 有 行为 ， 同 时 也 难以 在 既 
有 对 和 象 中 添加 新 行为 。 数 据 结构 曝露 数据 ， 没 有 明显 的 行为 。 便 于 疝 既 有 数据 结构 添加 新 行 
为 ， 同 时 也 难以 向 既 有 函数 添加 新 数据 结构 。 

在 任何 系统 中 ,我们 有 了 时 会 希望 能 够 灵活 地 添加 新 数据 类 型 ， 所 以 更 喜欢 在 这 部 分 使 用 
对 象 。 另外 一 些 时 候 , 我 们 希望 能 灵活 地 添加 新 行为 ,这 时 我 们 更 喜欢 使 用 数据 类 型 和 过 程 。 
优秀 的 软件 开发 者 不 带 成 见地 了 解 这 种 情形 ， 并 依据 手边 工作 的 性 质 选择 其 中 一 种 手段 。 


6.6 文献 


[Refactoring]: Refactoring: Improving the Desien of Existing Code, Martin Fowler et al., 
Addison- Wesley, 1999. 
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在 一 本 有 关 整 洁 代 码 的 书 中 ， 居 然 有 讨论 错误 处 理 的 章节 ， 看 起 来 有 些 突 几 。 错 误 处 理 
只 不 过 是 编程 时 必须 要 做 的 事 之 一 。 输 入 可 能 出 现 异 常 ， 设 备 可 能 失效 。 简 言 之 ， 可 能 会 出 
错 ， 当 错误 发 生 时 ， 程 序 员 就 有 责任 确保 代码 照常 工作 。 

然而 ， 应 该 弄 清楚 错误 处 理 与 整洁 代码 的 关系 。 许 多 程序 完全 由 错误 处 理 所 占 据 。 
所 谓 占据 ， 并 不 是 说 错误 处 理 就 是 全 部 。 我 的 意思 是 几乎 无 法 看 明白 代码 所 做 的 事 ， 因 
为 到 处 都 是 凌乱 的 错误 处 理 代码 。 错 误 处 理 很 重要 ， 但 如 果 它 搞 乱 了 代码 逻辑 ， 就 是 错 
误 的 做 法 。 
在 本 章 中 ， 我 将 概要 列 出 编写 既 整 滞 又 强 固 的 代码 一 一 雅致 地 处 理 错误 代码 的 一 些 技巧 
和 思路 。 | | 
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7.1 使 用 异常 而 非 返回 码 


在 很 久 以 前 ， 许 多 语言 都 不 支持 异常 。 这 些 语言 处 理 和 汇报 错误 的 手段 都 有 限 。 你 要 么 设 
置 一 个 错误 标识 ， 要 么 返回 给 调用 者 检查 的 错误 码 。 代 码 清单 7-1 中 的 代码 展示 了 这 些 手段 。 
代码 清单 7-1 DeviceController.java 


public class DeviceController { 


public void sendShutDown() { 
DeviceHandle handle = getHandle(DEV1); 
// Check the state of the device 
if (handle != DeviceHandle.INVALID) ( 
// Save the device status to the record field 
retrieveDeviceRecord (handle); 
// If not suspended, shut down 
if (record.getStatus() !- DEVICE SUSPENDED) { 
pauseDevice (handle); 
clearDeviceWorkQueue (handle); 
closeDevice (handle); 
} else í 
logger.log("Device suspended. Unable to shut down"); 
} 
} else { 
logger.log("Invalid handle for: " + DEV1.toString()); 
} 
} 


` EEN 
这 类 手段 的 问题 在 于 ， 它 们 搞 乱 了 调用 者 代码 。 调 用 者 必须 在 调用 之 后 即刻 检查 错误 。 
不 幸 的 是 ， 这 个 步骤 很 容易 被 遗忘 。 所 以 ， 遇 ASRI, REMENAR. 调用 代码 很 下 


洁 ， 其 逻辑 不 会 被 错误 处 理 搞 乱 。 
代码 清单 7.2 展示 了 在 方法 中 衣 到 错误 时 抛 出 异常 的 情形 


代码 清单 7-2 DeviceController.java (采用 异常 处 理 ) 


public class DeviceController { 





public void sendShutDown() { 
try ( | l ZEE atm op nen 
tryToShutDown () ; HE RT 
) catch (DeviceShutDownError e) { 
logger.log(e); 
) 
Cx a de PaL LL 
private void tryToShutDown() throws DeviceShutDownError { S > 
DeviceHandle handle = getHandle(DEV1); SR E EOS 
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DeviceRecord record = retrieveDeviceRecord (handle); 


pauseDevice (handle); 


设备 


clearDeviceWorkQueue (handle); 
closeDevice (handle); 


) | 
private DeviceHandle getHandle(DeviceID id) { 


throw new DeviceShutDownError("Invalid handle for: " * id.toString()); 


E E 
注意 这 段 代 码 整洁 了 很 多 。 这 不 仅 关 平 美观 。 这 段 代码 更 好 ， 因 为 之 前 纠结 的 两 个 元 素 
关闭 算法 和 错误 处 理 现在 被 隔离 了 。 你 可 以 查看 其 中 任 一 元 素 ， 分 别 理解 它 。 


7.2 %5 Try-Catch-Finally 语句 


分 的 


异常 的 妙 处 之 一 是 ， 它 们 在 程序 中 定义 了 一 个 范围 。 执 行 ty-catch-finally 语句 中 try 部 
代码 时 ， 你 是 在 表明 可 随时 取消 执行 ， 并 在 catch 语句 中 接续 。 


在 某 种 意义 上 ，try 代码 块 就 像 是 事务 。catch 代码 块 将 程序 维持 在 一 种 持续 状态 ， 无 论 ty 


代码 块 中 发 生 了 什么 均 如 此 。 所 以 ， 在 编写 可 能 抛 出 异常 的 代码 时 ， 最 好 先 写 出 try-catch-finally 


语句 





。 这 能 帮 你 定义 代码 的 用 户 应 该 期 待 什么， 无 论 try 代码 块 中 执行 的 代码 出 什么 错 都 一 样 。 
来 看 个 例子 。 我 们 要 编写 访问 某 个 文件 并 读 出 一 些 序列 化 对 象 的 代码 。 

先 写 一 个 单元 测试 ， 其 中 显示 当 文 件 不 存在 时 将 得 到 一 个 异常 : 

GTest(expected = StorageException.class) 


public void rettieveSectionShouldThrowOnInvalidFileName[) | 
sectionStore.retrieveSection("invalid - file"); 


} 
该 测试 驱动 我 们 创建 以 下 占 位 代码 : 


public List<RecordedGrip> retrieveSection(String sectionName) { 
// dummy return until we have a real implementation 
return new ArrayList<RecordedGrip>(); 


) ; | | 
测试 失败 了 ， 因 为 以 上 代码 并 未 抛 出 异常 。 下 一 步 ， 修 改 实现 代码 ， 尝 试 访问 非法 文件 。 
作 抛 出 一 个 异常 : 


public List<RecordedGrip> retrieveSection(String sectionName) { 


try { 
FileInputStream stream = new FileInputStream(sectionName) 
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) catch (Exception e) { 
throw new StorageException("retrieval error", e); 


) 


return new ArrayList«RecordedGrip»(); 


这 次 测试 通过 了 ， 因 为 我 们 捕获 了 异常 。 此 时 ， 我 们 可 以 重 构 了 。 我 们 可 以 缩小 异常 类 ] 
型 的 范围 ， 使 之 符合 FileInpufStream 构造 器 真正 抛 出 的 异常 ， 即 FileNotFoundException: —— | 


public List<RecordedGrip> retrieveSection(String sectionName) ( 


try { 
FileInputStream stream - new FileInputStream(sectionName); 
Stream.close(); | 

) catch (FileNotFoundException e) { 

throw new StorageException("retrieval error", e); 


) 


return new ArrayList«RecordedGrip?(); 
) 


如 此 一 来 ， 我 们 就 用 try-catch 结构 定义 了 一 个 范围 ， 可 以 继续 用 测试 驱动 CTDDO 方法 构建 “ 
剩余 的 代码 逻辑 。 这 些 代 码 逻 辑 将 在 FileInputStream 和 close 之 间 添 加 ， 装 作 一 切 正常 的 样子 。 “一 

尝试 编写 强行 抛 出 异常 的 测试 ， 再 往 处 理 器 中 添加 行为 ， 使 之 满足 测试 要 求 。 结 果 就 是 
你 要 先 构造 try 代码 块 的 事务 范围 ， 而 且 也 会 帮助 你 维护 好 该 范围 的 事务 特征 。 


7.3 ”使 用 不 可 控 异 常 


辩论 业已 结束 。 多 年 来 ，Java 程序 员 们 一 直 在 争论 可 控 异常 (checked exception) 的 利 与 
Bk. Java 的 第 一 个 版 本 中 引入 可 控 异 常 时 ， 看 似 一 个 极 好 的 点 子 。 每 个 方法 的 签名 都 列 出 它 
可 能 传递 给 调用 者 的 异常 。 而 且 ， 这 些 异 常 就 是 方法 类 型 的 一 部 分 。 如 果 签 名 与 代码 实际 所 
做 之 事 不 符 ， 代 码 在 字面 上 就 无 法 编译 。 

那 时 ， 我 们 认为 可 控 异 常 是 个 绝妙 的 主意 ;而 且 ， 它 也 有 所 神 益 。 然 而 ， 现 在 已 经 很 清 
楚 ， 对 于 强 固 软件 的 生产 ， 它 并 非 必需 。C# 不 支持 可 控 异 常 。 尽 管 做 过 勇敢 的 尝试 ，C++ 最 
后 也 不 支持 可 控 异 常 。Python 和 Ruby 同样 如 此 。 不 过 ， 用 这 些 语 FER 号 出 强 固 的 软 
件 。 我 们 得 决定 一 一 的 确 如 此 一 一 可 控 异 常 是 否 值 回 票 价 。 

代价 是 什么 ? 可 控 异 常 的 代价 就 是 违反 开放 /闭合 原则 。 如 果 你 在 方法 中 抛 出 可 控 异 常 
而 catch 语句 在 三 个 层级 之 上 , 你 就 得 在 catch 语句 和 抛 出 异常 处 之 间 的 每 个 方法 签名 中 声明 
该 异常 。 这 意味 着 对 软件 中 较 低 层级 的 修改 ， 都 将 波及 较 高 层级 的 签名 。 修 改 好 的 模块 必须 
重新 构建 、 发 布 ， 即 便 它 们 自身 所 关注 的 任何 东西 都 没 改 动 过 。 | 

以 某 个 大 型 系统 的 调用 层级 为 例 。 顶 端 函数 调用 它们 之 下 的 函数 ， 逐 级 向 下 。 假 设 某 个 
位 于 最 底层 级 的 函数 被 修改 为 抛 出 一 个 异常 。 如 果 该 异常 是 可 控 的 ， 则 函数 签名 就 要 添加 


' 原 注 : [Martin]. 
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throw 子 句 。 这 意味 着 每 个 调用 该 函数 的 函数 都 要 修改 ， 捕 获 新 异常 ， 或 在 其 签名 中 添加 合 
适 的 throw 子 句 。 以 此 类 推 。 最 终 得 到 的 就 是 一 个 从 软件 最 底 端 贯穿 到 最 高 端的 修改 链 ! 封 
装 被 打破 了 ， 因 为 在 抛 出 路 径 中 的 每 个 函数 都 要 去 了 解 下 一 层级 的 异常 细节 。 既 然 异 常 则 
让 你 能 在 较 远 处 处 理 错 误 ， 可 控 异 常 以 这 种 方式 破坏 封装 简直 就 是 一 种 耻辱 。 

如 果 你 在 编写 一 套 关 键 代码 库 ， 则 可 控 异 常 有 时 也 会 有 用 : 你 必须 捕获 异常 。 但 对 于 一 
般 的 应 用 开发 ， 其 依赖 成 本 要 高 于 收益 。 


7.4 给 出 异常 发 生 的 环境 说 明 


你 抛 出 的 每 个 异常 ， 都 应 当 提 供 足够 的 环境 说 明 ， 以 便 判断 错误 的 来 源 和 处 所 。 在 Java 中 ， 
你 可 以 从 任何 异常 里 得 到 堆栈 踪迹 (stack trace); 然而 , 堆栈 踪迹 却 无 法 告诉 你 该 失败 操作 的 初衷。 
”应 创建 信息 充分 的 错误 消息 ， 并 和 有 异常 一 起 传递 出 去 。 在 消息 中 ， 包 括 失败 的 操作 和 失 
败类 型 。 如 果 你 的 应 用 程序 有 日 志 系统 ， 传 递 足够 的 信息 给 catch 块 ， 并 记录 下 来 。 


7.9 依 调用 者 需要 定义 异常 类 


对 错误 分 类 有 很 多 方式 。 可 以 依 其 来 源 分 类 : 是 来 自 组 件 还 是 其 他 地 方 ? 或 依 其 类 型 分 
类 : 是 设备 错误 、 网 络 错误 还 是 编程 错误 ”不 过 ， 当 我 们 在 应 用 程序 中 定义 异常 类 时 ， PR 
AE 何 被 捕获 。 

来 看 一 个 不 太 好 的 异 常 分 类 例子 。 下 面 的 try-catch-finally 语句 是 对 某 个 第 三 方 代 码 库 的 
调用 。 它 覆盖 了 该 调用 可 能 抛 出 的 所 有 有 异常 : 


ACMEPort port = new ACMEPort (12); 





try { 
port.open(); 
catch (DeviceResponsekxception e) ( 
reportPortError (e); 
logger.log("Device response exception", e); 
catch (ATM1212UnlockedException e) { 
reportPortError (e); 
logger.log("Unlock exception", e); 
) catch (GMXError e) ( 
reportPortError (e); 
logger.log(" Device response exception"); 
) pene { 


— 


p 


8 
语句 包含 了 一 大 堆 重 复 代码 ， 这 并 不 出 奇 。 在 大 多 数 异 常 处 理 中 ， 不 管 真实 原因 如 何 ， 
我 们 总 是 做 相对 标准 的 处 理 。 我 们 得 记录 错误 ， 确 保 能 继续 工作 。 
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在 本 例 中 ， 既 然 知 道 我 们 所 做 的 事 不 外 如 此 ， 就 可 以 通过 打包 调用 API、 确 保 它 返回 通 
用 异常 类 型 ， 从 而 简化 代码 。 | 


 LocalPort port = new LocalPort (12); 
try ( 
port. open () ; 

) catch (PortDeviceFailure e) ( 
reportError (e); 
logger.log(e.getMessage(), e); 

) finally ( 


LocalPort 类 就 是 个 简单 的 打包 类 ， 捕 获 并 翻译 由 ACMEPort 类 抛 出 的 异常 : 


public class LocalPort { 
private ACMEPort innerPort; 


public LocalPort(int portNumber) { 
innerPort - new ACMEPort (portNumber); 
) 


public void open() { 
try { 
innerPort.open(); 
) catch (DeviceResponseException e) ( 
throw new PortDeviceFailure (e); 
) catch (ATM1212UnlockedException e) 1 
throw new PortDeviceFailure (e); 
} catch (GMXError e) { 
throw new PortDeviceFailure (e); 
) 
y 
} | $ 
类 似 我 们 为 ACMEPort 定义 的 这 种 打包 类 非常 有 用 。 实 际 上 ， 将 第 三 方 API 打包 是 个 良 
好 的 实践 手段 。 当 你 打包 一 个 第 三 方 API， 你 就 降低 了 对 它 的 依赖 ， 未 来 你 可 以 不 太 痛 苦 地 
改 用 其 他 代码 库 。 在 你 测试 自己 的 代码 时 ， 打 包 也 有 助 于 模拟 第 三 方 调用 。 c 
打包 的 好 处 还 在 于 你 不 必 绑 死 在 某 个 特定 厂商 的 API 设计 上 。 你 可 以 定义 自己 感觉 舒服 的 
API. 在 上 例 中 , 我们 为 port 设备 错误 定义 了 一 个 异常 类 型 ， 然 后 发 现 这 样 能 号 出 更 整洁 的 代码 。 
对 于 代码 的 某 个 特定 区 域 ， 单 一 异常 类 通常 可 行 。 伴 随 异 常 发 送出 来 的 信息 能 够 区 分 不 
同 错误 。 如 果 你 想 要 捕获 某 个 异常 ， 并 且 放 过 其 他 异常 ， 就 使 用 不 同 的 异常 类 。 


7.6 定义 常规 流程 


如 果 你 遵循 前 文 提 及 的 建议 ， 在 业务 逻辑 和 错误 处 理 代 码 之 间 就 会 有 良好 的 区 隔 。 大 量 
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代码 会 开始 变 得 像 是 整洁 而 简朴 的 算法 。 然 而 ， 
这 样 做 却 把 错误 检测 推 到 了 程序 的 边缘 地 带 。 你 
打包 了 外 部 API 以 抛 出 自己 的 异常 ， 你 在 代码 的 
顶端 定义 了 一 个 处 理 器 来 应 付 任 何 失 败 了 的 运 
算 。 在 大 多 数 时 候 ， 这 种 手段 很 棒 ， 不 过 有 时 你 
也 许 不 愿 这 么 做 。 

来 看 一 个 例子 。 下 面 的 笨 代 码 来 目 某 个 记 幅 
应 用 的 开支 总 计 模 块 : 


try { 
MealExpenses expenses = expenseReportDAO. getMeals (employee. ge EP 
m total += expenses.getTotal(); 

) catch (MealExpensesNotFound e) { 
m total += getMealPerDiem(); 

) 


das, MRA TER, WASH. UDRSCHIHTG. Wm DS) EDAURO 
贴 。 异 常 打 断 了 业务 逻辑 。 如 果 不 去 处 理 特 殊 情况 会 不 会 好 一 些 ? 那样 的 话 代码 看 起 来 会 更 
简洁 。 就 像 这 样 : 

MealExpenses expenses = expenseReportDAO.getMeals (employee.getID()); 

m total += expenses.getTotal(); 


能 把 代码 写 得 那样 简洁 吗 ? 能 .可 以 修改 ExpenseReportDAO, 使 其 总 是 返回 MealExpense 
对 象 。 如 果 没 有 和 父 食 消 耗 ， 就 返回 一 个 返回 餐 食 补贴 的 MealExpense NS, 


public class PerDiemMealExpenses implements MealExpenses { 
public int getTotal() { 
// return the per diem default 
) 
) 
这 种 手法 叫做 特例 模式 (SPECIAL: CASE PATTERN, [Fowler])。 创 建 一 个 类 或 配置 一 个 
对 象 ， 用 来 处 理 特例。 你 来 处 理 特例 ， 客 户 代 码 就 不 用 应 付 异常 行为 了 。 异 常 行为 被 封装 到 


特例 对 象 中 。 








7.7 别 返 回 null 值 


我 认为 , 要 讨论 错误 处 理 , 就 一 定 要 提 及 那些 容易 引发 错误 的 做 法 。 第 一 项 就 是 返回 null 
E. 我 不 想 去 计算 曾经 见 过 多 少 几乎 每 行 代码 都 在 检查 null 值 的 应 用 程序 。 下面 就 是 个 例子 : 


public void registerItem(Item item) { 
if (item != null) { 
ItemRegistry registry = peristentStore.getItemRegistry(); 
if (registry != null) ( 
Item existing = registry.getItem(item.getID()); 
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if (existing.getBillingPeriod().hasRetailOwner()) { 
existing.register (item); 
) 
) 
) 
) 


这 种 代码 看 似 不 坏 ， 其 实 糟 透 了 ! 返回 null 值 ， 基 本 上 是 在 给 自己 增加 工作 量 ， 也 是 在 
给 调用 者 添乱 。 只 要 有 一 处 没 检查 null 值 ， 应 用 程序 就 会 失控 。 

你 有 没有 注意 到 ， 峰 套 if 语句 的 第 二 行 没有 检查 null f? 如 果 在 运行 时 persistentStore 
A null 会 发 生 什么 事 ? 我 们 会 在 运行 时 得 到 一 个 NullPointerException 异常 , 也许 有 人 在 代码 
顶端 捕获 这 个 异常 ， 也 可 能 没有 捕获 。 两 种 情况 都 很 粳 糕 。 对 于 从 应 用 程序 深 处 抛 出 的 
NullPointerException 异常 ， 你 到 底 该 作 何 反应 呢 ? 

可 以 表 衍 说 上 列 代码 的 问题 是 少 做 了 一 次 null 值 检 查 ， 其 实 问题 多 多 。 如 果 你 打算 在 方 
法 中 返回 null 值 ， 不 如 抛 出 异常 ， 或 是 返回 特例 对 象 。 如 果 你 在 调用 某 个 第 三 方 API 中 可 能 
返回 null 值 的 方法 , 可 以 考虑 用 新 方法 打包 这 个 方法 , 在 新 方法 中 抛 出 异常 或 返回 特例 对 象 。 
在 许多 情况 下 ， 特 例 对 象 都 是 爽口 良药 。 设 想 有 这 么 一 段 代码 ; 


List<Employee> employees = getEmployees(); 
if (employees !- null) ( 
for(Employee e : employees) { 
totalPay += e.getPay(); 
) 
) 


现在 ， getExployees 可 能 返回 null， 但 是 否 一 定 要 这 人 么 做 呢 ? 如 果 修 改 getEmployee, 3& 
回 空 列表 ， 就 能 使 代码 整洁 起 来 : 


List«Employee» employees = getEmployees(); 
for(Employee e : employees) { 

totalPay += e.getPay(); 
) | 


FÆ Java 有 Coleone Lk, 该 方法 返回 一 个 预定 义 不 可 变 列表 , 可 用 于 这 种 目的 ; 


public List<Employee> getEmployees() { 
if( .. there are no employees .. ) 
return Collections.emptyList(); 
} 


这 样 编码 ， 就 能 尽量 避免 NullPointerException 的 出 现 ， 代 码 也 就 更 整洁 了 。 


7.8 SẸ% null 值 


在 方法 中 返回 null 值 是 糟糕 的 做 法 ， 但 将 null 值 传递 给 其 他 方法 观 更 糟糕 了 。 除 非 API 
要 求 你 同 它 传 递 null 值 ， 否 则 就 要 尽 可 能 避免 传递 null 值 。 
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举例 说 明 原 因 。 用 下 面 这 个 简单 的 方法 计算 两 点 的 投射 ， 


public class MetricsCalculator 
{ | , 
public double xProjection(Point pl, Point p2) { 
return (p2.x - pl.x) * 1.5; 
) 
) 

”如 果 有 人 传 入 null 值 会 怎样 ? 
calculator.xProjection(null, new Point (12, 13)); 
当然 ， 我 们 会 得 到 一 个 NullPointerException 异常 。 

如 何 修正 ? 可 以 创建 一 个 新 异常 类 型 并 抛 出 : 


public class MetricsCalculator 
{ 
public double xProjection(Point pl, Point p2) { 
if (pl == null || p2 == null) { 
" throw InvalidArgumentException ( 
"Invalid argument for MetricsCalculator.xProjection") ; 
} 
return (p2.x - pl.x) * 1.5; 
) 
) 


这 样 做 好 些 吗 ? 可 能 比 null 指针 异常 好 一 些 , 但 要 记 住 , 我 们 还 得 为 InvalidArgumentException 
异常 定义 处 理 器 。 这 个 处 理 器 该 做 什么 ? 还 有 更 好 的 做 法 吗 ? 
还 有 替代 方案 。 可 以 使 用 一 组 断言 ; 


public class MetricsCalculator 
{ 
public double xProjection (Point pi, Point p2) { 
t Il er should not De num"; 






robur, rest ore Lie 
} 
} 


看 上 去 很 美 ， 但 仍 未 解决 问题 。 如 果 有 人 传 入 null 值 ， 还 是 会 得 到 运行 时 错误 。 

在 大 多 数 编程 语言 中 ， 没 有 良好 的 方法 能 对 付 由 调用 者 意外 传 入 的 null 值 。 事 已 如 此 ， 
恰当 的 做 法 就 是 禁止 传 入 null 值 。 这 样 ， 你 在 编码 的 时 候 ， 就 会 时 时 记 住 参数 列表 中 的 null 
值 意味 着 出 问题 了 ， 从 而 大 量 避 免 这 种 无 心 之 失 。 


7.9 小 结 
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大 地 提升 了 代码 的 可 维护 性 
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我 们 很 少 控制 系统 中 的 全 部 软件 。 有 时 我 们 购买 第 三 方程 序 包 或 使 用 开放 源 代码 ， 有 时 
我 们 依靠 公司 中 其 他 团队 打造 组 件 或 子 系统 。 不 管 是 哪 种 情况 ， 我 们 都 得 将 外 来 代码 干净 利 
落地 整合 进 上 自己 的 代码 中 。 本 章 将 介绍 一 些 保持 软件 边界 整洁 的 实践 手段 和 技巧 。 
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8.1 使 用 第 三 方 代码 


”在 接口 提供 者 和 使 用 者 之 间 ， 存 在 与 生 俱 来 的 张力 。 第 三 方程 序 包 和 框架 提供 者 追求 普 
适 性 ， 这 样 就 能 在 多 个 环境 中 工作 ， 吸 引 广泛 的 用 户 。 而 使 用 者 则 想 要 集中 满足 特定 需求 的 
接口 。 这 种 张力 会 导致 系 统 边 界 上 出 现 问题 。 | 

以 java.util.Map 为 例 。 如 你 在 表 8-1 PATIL, Map 有 着 广阔 的 接口 和 丰富 的 功能 。 当 然 ， 

这 种 力量 和 灵活 性 很 有 用 ， 但 也 要 付出 代价 。 比 如 ， 应 用 程序 可 能 构造 一 个 Map 对 象 并 传递 
它 。 我 们 的 初衷 可 能 是 Map 对 象 的 所 有 接收 者 都 不 要 删除 映射 图 中 的 任何 东西 。 但 表 8-1 的 
顶端 却 正 好 有 一 个 clear( ) 方 法 。Map 的 任何 使 用 者 都 能 清除 映射 图 。 或 许 设 计 惯 例 是 Map 
中 只 能 保存 特定 的 类 型 , 但 Map 并 不 会 可 靠 地 约束 存 于 其 中 的 对 象 的 类 型 。 使 用 者 可 随意 往 
Map 中 塞 入 任何 类 型 的 条 目 。 


clear() void - Map 

containsKey(Object key) boolean - Map 
containsValue(Object value) boolean - Map 
entrySet() Set - Map 

equals (Object o) boolean - Map 

get(Object key) Object - Map 

getClass() Class«? extends Object» - Object 
hashCode() int - Map 

isEmpty() boolean - Map 

keySet() Set - Map 

notify() void - Object 

notifyAll() void - Object 

put(Object key, Object value) Object - Map 
putAll(Map t) void - Map 

remove (Object key) Object - Map 

Size() int - Map | 

toString() String - Object 

values() Collection - Map 

wait() void - Object 


wait(long timeout) void - Object 


wait(long timeout, int nanos) void - Object 


8-1 Mop 类 的 方法 
如 果 你 的 应 用 程序 需要 一 个 包容 Sensor 类 对 象 的 Map 映射 图 ， 大 概 会 是 这 样 : 
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Map sensors = new HashMap(); 

当代 码 的 其 他 部 分 需要 访问 这 些 sensor， 就 会 有 这 行 代码 : 

Sensor s = (Sensor)sensors.get(sensorId ); 

这 行 代码 一 再 出 现 。 代码 的 调用 端 承担 了 从 Map 中 取得 对 象 并 将 其 转换 为 正确 类 型 的 职 
责 。 行 倒是 行 ， 却 并 非 整 洁 的 代码 。 而 且 ， 这 行 代码 并 未 说 明 自己 的 用 途 。 通过 对 泛 型 的 使 
用 ， 这 段 代码 可 读 性 可 以 大 大 提高 ， 如 下 所 示 : 


Map<Sensor> sensors = new ASE RAEAN 


Sensor s = sensors. gei UNUS IG e 


不 过 ，Map<Sensor> 提 供 了 超 出 所 需 /所 愿 的 功能 的 问题 仍 未 得 到 解决 。 

在 系统 中 不 受 限 制 地 传递 Map<Sensor> 的 实体 ， 意味 着 当 到 Map 的 接口 被 修改 时 ， 有 许 
多 地 方 都 要 跟着 改 。 你 或 许 会 认为 这 样 的 改动 不 太 可 能 发 生 ， 不 过 ， 当 Java 5 加 入 对 泛 型 的 
支持 时 , 的 确 发 生 了 改动 ,我 们 也 的 确 见 到 一 些 系统 因为 要 做 大 量 改动 才能 自由 使 用 Map 类 ， 
而 无 法 使 用 泛 型 。 | 

使 用 Map 的 更 整洁 的 方式 大 致 如 下 。 Sensors 的 用 户 不 必 关 心 是 否 用 了 泛 型 , 那 将 是 (也 
Be) 实现 细节 才 关 心 的 。 

public class Sensors ( 


private Map sensors = new HashMap(); 


public Sensor getById(String id) ( 
return (Sensor) sensors.get (id); 


) 


| // 片 段 | 
边界 上 的 接口 (Map) 是 隐藏 的 。 它 能 随 来 自 应 用 程序 其 他 部 分 的 极 小 的 影响 而 变动 。 
对 泛 型 的 使 用 不 再 是 个 大 问题 ， 因 为 转换 和 类 型 管理 是 在 Sensors 类 内 部 处 理 的 。 

该 接口 也 经 过 仔细 修整 和 归 置 以 适应 应 用 程序 的 需要 。 结 果 就 是 得 到 易于 理解 、 难 以 被 
误 用 的 代码 。Sensors 类 推动 了 设计 和 业务 的 规则 。 
我 们 并 不 建议 er dap D er ENEE 






ESTA 


8.2 ”浏览 和 学 习 边界 


第 三 方 代码 帮助 我 们 在 更 少时 间 内 发 布 更 丰富 的 功能 。 在 利用 第 三 方程 序 包 时 ， 该 从 何 
处 入 手 呢 ?我 们 没有 测试 第 三 方 代码 的 职责 ， 但 为 要 使 用 的 第 三 方 代码 编写 测试 ， 可 能 最 符 
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学 习性 测试 毫 无 成 本 。 无 论 如 何 我 们 都 得 学 习 要 使 用 的 API， 而 编写 测试 则 是 获得 这 些 
知识 的 容易 而 不 会 影响 其 他 工作 的 途径 。 学 习性 测试 是 一 种 精确 试验 ， 帮 助 我 们 增进 对 API 
的 理解 。 

学 习性 测试 不 光 免费 ， 还 在 投资 上 有 正面 的 回报 。 当 第 三 方程 序 包 发 布 了 新 版 本 ， 我 们 
可 以 运行 学 习性 测试 ， 看 看 程序 包 的 行为 有 没有 改变 。 

学 习性 测试 确保 第 三 方程 序 包 按照 我 们 想 要 的 方式 工作 。 一 旦 整合 进来 ， 就 不 能 保证 第 
三 方 代码 总 与 我 们 的 需要 兼容 。 原 作者 不 得 不 修改 代码 来 满足 他 们 自己 的 新 需要 。 他 们 会 修 
正 缺 陷 、 添 加 新 功能 。 风 险 伴随 新 版 本 而 来 。 如 果 第 三 方程 序 包 的 修改 与 测试 不 兼容 ， 我 们 
也 能 马上 发 现 。 

无 论 你 是 否 需 要 通过 学 习性 测试 来 学 习 ， 总 要 有 一 系列 与 生产 代码 中 调用 方式 一 致 的 输 
出 测试 来 支持 整洁 的 边界 。 不 使 用 这 些 边 界 测试 来 减轻 迁移 的 劳力 ， 我 们 可 能 会 超出 应 有 时 
限 ， 长 久 地 绑 在 旧版 本 上 面 。 


8.5 “使 用 尚 不 存在 的 代码 


还 有 另 一 种 边界 ， 那 种 将 已 知 和 未 知 分 隔 开 的 边界 。 在 代码 中 总 有 许多 地 方 是 我 们 的 
知识 未 及 之 处 。 有 时 ， 边 界 那 边 就 是 未 知 的 〈 至 少 目前 未 知 )。 有 时 ， 我 们 并 不 往 边界 那 边 
看 过 去 。 | 

好 多 年 以 前 ， 我 曾 在 一 个 开发 无 线 通 信 系 统 软件 的 团队 中 工作 。 该 系统 有 个 子 系统 
Transmitter (发 送 机 )。 我 们 对 Transmitter 知之 甚 少 ， 而 该 子 系统 的 开发 者 还 没有 对 接口 进行 
定义 。 我 们 不 想 受 这 种 事 阻 碍 ， 就 从 距 未 知 那 部 分 代码 很 远 处 开始 工作 。 

对 于 我 们 的 世界 如 何 结束 、 新 世界 如 何 开 始 ， 我 们 有 许多 好 主意 。 工 作 时 ， 我 们 偶尔 会 
跨越 那 道 边界 。 尽 管 云雾 遮挡 了 我 们 看 向 边界 那 边 的 视线 ， 我 们 还 是 从 工作 中 了 解 到 我 们 想 
要 的 边界 接口 是 什么 样 的 。 我 们 想 要 告知 发 送 机 一 些 事 : 

将 发 送 机 置 于 指定 频率 ， 并 发 出 自 这 个 流 得 到 的 数据 的 模拟 表示 。 

我 们 不 知 这 会 如 何 做 到 ， 因 为 API 还 没 设计 出 来 。 所 以 ， 我 们 决定 过 后 再 编写 细节 代码 。 

为 了 不 受阻 得， 我 们 定义 了 自己 使 用 的 接口 。 我 们 给 它 取 了 个 好 记 的 名 字 ， 比 如 
Transmitter。 我 们 给 它 写 了 个 名 为 transmit 的 方法 ， 获 取 频 率 参 数 和 数据 流 。 这 就 是 我 们 希望 
得 到 的 接口 。 
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编写 我 们 想得到 的 接口 , 好 处 之 一 是 它 在 我 们 控制 之 下 。 这 有 助 于 保持 客户 代码 更 可 读 ， 
且 集 中 于 它 该 完成 的 工作 。 

在 图 8-2 中 可 以 看 到 ， 我 们 将 CommunicationsController 类 从 发 送 器 API (该 API 不 受 
RNB, MACKEN) 中 隔离 出 来 。 通 过 使 用 符合 应 用 程序 的 接口 ， 
CommunicationsController 代码 整洁 且 足 以 表达 其 意图 。 一 旦 发 送 器 API 被 定义 出 来 ， 我 们 
就 编写 TransmitterAdapter 来 跨 接 。ADAPTER' 封 装 了 与 API 的 互动 ， 也 提供 了 一 个 当 API 
发 生变 动 时 唯一 需要 改动 的 地 方 。 | 


.. <<interface>> 
通信 控制 器 Transmitter 


+transmit (frequency, stream) 


Transmitter <<future>> 
Adapter Transmitter API 
图 8-2 ”对 发 送 器 的 预测 


这 套 设计 方案 为 测试 提供 了 一 种 极为 方便 的 接 终 *。 使 用 适当 的 FakeTransmitter， 我 们 就 
能 测试 CommunicationsController 类 。 在 拿 到 TransmitterAPI 时 ， 我 们 也 能 创建 确保 正确 使 用 
API 的 边界 测试 。 
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边界 上 会 发 生 有 趣 的 事 。 改 动 是 其 中 之 一 。 有 良好 的 软件 设计 ， 无 需 巨大 投入 和 重 写 
即 可 进行 修改 。 在 使 用 我 们 控制 不 了 的 代码 时 ， 必 须 加 倍 小 心 保护 投资 ， 确 保 未 来 的 修改 
不 至 于 代价 太 大 。 | | 

边界 上 的 代码 需要 清晰 的 分 割 和 定义 了 期 望 的 测试 。 应 该 避免 我 们 的 代码 过 多 地 了 解 第 三 
方 代码 中 的 特定 信息 。 依靠 你 能 控制 的 东西 , 好 过 依靠 你 控制 不 了 的 东西 , 免得 日 后 受 它 控制 。 
”我 们 通过 代码 中 少数 几 处 引用 第 三 方 边界 接口 的 位 置 来 管理 第 三 方 边 界 。 可 以 像 我 们 对 

待 Map 那样 包装 它们 ， 也 可 以 使 用 ADAPTER 模式 将 我 们 的 接口 转换 为 第 三 方 提供 的 接口 。 
采用 这 两 种 方式 ， 代 码 都 能 更 好 地 与 我 们 沟通 ， 在 边界 两 边 推动 内 部 一 致 的 用 法 ， 当 第 三 方 
代码 有 改动 时 修改 点 也 会 更 少 。 


' 原 注 ， 见 [GOF] 中 的 Adapter 模式 。 
> FAYE: 在 [WELC] 中 可 查阅 更 多 关于 接 缝 (seam) 的 信息 。 
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R -5 
”过 去 十 年 以 来 ， 编 程 专业 领域 进步 很 大 。1997 年 时 ， 没 人 听 说 过 测试 驱动 开发 。 对 于 我 
_ 们 之 中 的 大 多 数 人 来 说 ， 单 元 测试 是 那 种 用 来 确保 程序 “可 运行 ”的 用 过 即 扔 的 短 代码 。 我 
们 辛勤 地 编写 类 和 方法 ,再 弄 出 一 些 特 殊 代码 来 测试 它们 。 通常 这 会 是 种 简单 的 驱动 式 程序 ， 
让 我 们 能 够 手工 与 自己 编写 的 程序 交互 。 

我 记得 在 20 世纪 90 年代 曾 为 一 套 谋 入 式 实时 系统 编写 过 C++ 程序。 该 程序 是 个 简单 的 
-计时 器 ， 有 如 下 签名 : 


J void Timer::ScheduleCommand (Command* theCommand, int milliseconds) 
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想法 很 简单 到 达 指 定 塞 秒 数 时 ， 在 一 个 新 线程 中 执行 Command 的 excute 方法 。 问 题 
在 于 如 何 测 试 它 。 

我 随便 写 了 个 简单 的 驱动 式 程序 ， 聆 听 来 自 键盘 的 动作 。 键 盘 输 入 一 个 字符 时 ， 它 就 安 
排 5 秒 钟 之 后 输出 同样 的 字符 。 我 输入 了 一 句 带 节奏 的 歌词 ， 然 后 等 着 5 秒 钟 之 后 它 在 屏幕 
上 重 现 出 来 。 | 

I... want-a-girl .. . just.. Win Ge ab, who-marr . . „ied... dear .. . old. ..dadl! | 

在 按 下 那些 ^." it, SEENEN, SAIL SHEER E, 我 又 再 哼 了 一 次 。 

那 就 是 我 的 测试 ! 我 看 到 这 法 子 可 行 ， 演 示 给 同事 们 看 ， 然 后 就 把 代码 扔 掉 了 。 

如 前 文 所 述 ， 我 们 的 专业 领域 进步 甚 多。 如今， 我 会 编写 测试 ， 确 保 代码 中 每 个 特 角 如 
网 都 如 我 所 愿 地 工作 。 我 会 将 代码 和 操作 系统 隅 离开 ， 而 不 是 直接 调用 标准 计时 功能 。 我 会 
伪造 一 套 计 时 函数 ， 这 样 就 能 全 面 控 制 时 间 。 我 会 安排 一 些 设置 布尔 值 标识 的 命令 ， 往 前 步 
进 时 间 ， 查 看 这 些 标 识 ， 确 保 它们 在 我 将 时 间 调 到 正确 值 时 由 false 变 为 true。 

有 了 一 套 运行 通过 的 测试 ， 我 会 确保 任何 需要 用 到 代码 的 人 都 能 方便 地 使 用 这 些 测试 。 
我 会 确保 测试 和 代码 一 起 签 入 同一 个 代码 包 。 

对 ， 我 们 进步 其 多 ; 但 还 有 很 长 的 路 要 走 。 敏 捷 和 TDD 运动 鼓舞 了 许多 程序 员 编 写 自 
动 化 单元 测试 ， 每 天 还 有 更 多 人 加 入 这 个 行列 。 但 是 ， 在 争先 恐 后 将 测试 加 入 规程 中 时 ， 许 
多 程序 员 遗 漏 了 一 些 关 于 编写 好 测试 的 更 细微 但 却 重要 的 要 点 。 | 


9.1 TDD 三 定律 


谁 都 知道 TDD BRBAERS EP TAT EATI. (RE URL EVA LZ RE 
看 看 下 列 三 d 


CES a ES eS DR CREUSE IC 
这 三 条 定律 将 你 限制 在 大 概 30 秒 一 个 的 循环 中 。 测试 与 生产 代码 一 起 编号 , 测试 只 比 生 
产 代码 早 写 几 秒 钟 。 
这 样 写 程序 ， 我 们 每 天 就 会 编写 数 十 个 测试 ， 每 个 月 编写 数 百 个 测试 ， 每 年 编写 数 千 个 
测试 。 这 样 写 程序 ， 测 试 将 覆盖 所 有 生产 代码 。 测试 代码 量 足 以 匹敌 生产 代码 量 ， 导致 令 人 
生 蔷 的 管理 问题 。 





! 译注 : I want a girl just like the girl who married dear old dad 是 20 世纪 初 American Quartet 四 重唱 乐队 的 歌曲 名 ， 也 是 歌 
词 中 的 一 句 ， 这 里 不 做 翻译 。 

” 原 注 : Professionalism and Test-Driven Robert C. Martin, Object Mentor, IEEE Software, May/June 2007 (Vol. 24, 
No.3)  pp.32-36. 
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9.2 ”保持 测试 整洁 


几 年 前 ， 有 人 请 我 去 指导 一 个 开发 团队 。 那 个 团队 认定 ， 测 试 代码 的 维护 不 应 遵循 生产 
代码 的 质量 标准 。 他 们 彼此 默许 在 单元 测试 中 破坏 规矩 。“ 速 而 不 周 ” 成 了 团队 格言 。 变 量 命 
名 不 用 好 ， 测 试 函数 不 必 短小 和 具有 描述 性 。 测 试 代码 不 必 做 良好 设计 和 仔细 划分 。 只 要 测 
试 代码 还 能 工作 ， 只 要 还 履 盖 着 生产 代码 ， 就 足够 好 。 0 

有 些 读者 可 能 会 同意 这 种 做 法 。 或 许 ， 在 很 久 以 前 ， 你 也 用 过 我 为 那个 Timer 类 写 测试 
的 方法 。 从 编写 那 种 用 后 即 扔 的 测试 到 编写 全 套 自动 化 单元 测试 是 一 大 进步 。 所 以 ， 就 像 那 
个 我 指导 过 的 团队 一 样 ， 你 或 许 也 会 认为 脏 测试 好 过 没 测试 。 

这 个 团队 没有 意识 到 的 是 , 脏 测 试 等 同 于 一 如 果 不 是 坏 于 的 话 一 没 测试 ,问题 在 于 ， 
测试 必须 随 生产 代码 的 演进 而 修改 。 测 试 越 脏 ， 就 越 难 修改 。 测 试 代码 越 缠 结 ， 你 就 越 有 可 
能 花 更 多 时 间 骞 进 新 测试 , 而 不 是 编写 新 生产 代码 。 修 改 生产 代码 后 ， 旧 测试 就 会 开始 失败 ， 
而 测试 代码 中 乱七八糟 的 东西 将 阻碍 代码 再 次 通过 。 于 是 , 测试 变 得 就 像 是 不 断 翻番 的 债务 。 

随 着 版 本 递 进 ， 团 队 维 护 测试 代码 组 的 代价 也 在 上 升 。 最 终 ， 它 变 成 了 开发 者 最 大 的 抱 
钨 对 象 。 当 经 理 们 问 及 为 何 超支 如 此 巨 大， 开发 者 们 就 归 答 于 测试 。 最 后 ， 他 们 只 能 扔 挤 了 
整个 测试 代码 组 。 

但 是 ， 没 有 了 测试 代码 组 ， 他 们 就 失去 了 确保 对 代码 的 改动 能 如 愿 工作 的 能 力 。 没 有 了 
测试 代码 组 ， 他 们 就 无 法 确保 对 系统 某 个 部 分 的 修改 不 会 影响 到 系统 的 其 他 部 分 。 故 障 率 开 
始 增 加 。 随 着 并 非 出 自 有 意 的 故障 越 来 越 多 , 他 们 开始 害怕 做 改动 。 他 们 不 再 清理 生产 代码 ， 
因为 他 们 害怕 修改 带 来 的 损害 多 于 收益 。 生 产 代码 开始 腐 坏 。 最 后 ， 他 们 只 剩 下 没有 测试 、 
纷乱 而 缺陷 缠身 的 生产 代码 ， 泪 次 的 客户 ， 还 有 对 测试 的 失望 。 

在 茶 种 意义 上 ,他们 说 对 了 。 测 试 的 确 让 他 们 失望 。 不 过 是 他 们 目 己 决定 让 测试 变 得 乱 
七 八 糟 的 ， 而 那 正 是 失败 的 根源 。 如 果 他 们 保持 测试 整洁 ， 测 试 就 不 会 令 他 们 失望 。 我 可 以 
TELE TALI A Ue, 4. SORA. CR AARTEN 





测试 带 来 一 切 好 处 


如 果 测 试 不 能 保持 整洁 ， 你 就 会 失去 它们 。 没 有 了 测试 ， 你 就 会 失去 保证 生产 代码 可 扩 
展 的 一 切 要 素 。 你 没 看 错 。 正 是 单元 测试 让 你 的 代码 可 扩展 、 可 维护 、 可 复 用 。 原 因 很 简单 。 
有 了 测试 ， 你 就 不 担心 对 代码 的 修改 ! 没有 测试 ， 每 次 修改 都 可 能 带 来 缺陷 。 无 论 架构 多 有 
扩展 性 ， 无 论 设计 划分 得 有 多 好 ， 没 有 了 测试 ， 你 就 很 难 做 改动 ， 因 为 你 担忧 改动 会 引入 不 
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可 预知 的 缺陷 。 

有 了 测试 , REAM. 测试 覆盖 率 越 高 ， 你 就 越 不 担心 。 哪 怕 是 对 于 那 种 架构 并 不 优秀 、 
设计 星 涩 纠缠 的 代码 , 你 也 能 近乎 没有 后 患 地 做 修改 。 实 际 上 , 你 能 毫 无 顾虑 地 改进 架构 和 设计 1! 

所 以 ， 履 次 了 生产 代码 的 CER 2 
试 带 来 了 一 切 好 处 ， 因 为 测试 使 改动 变 得 可 能 。 

如 果 测 试 不 干净 ， 你 改动 目 己 代码 的 能 力 就 有 所 牵制 ， 而 你 也 会 开始 失去 改进 代码 结构 
的 能 力 。 测 试 越 胜 ， 代 码 就 会 变 得 越 胜 。 最 终 ， 你 丢失 了 测试 ， 代 码 开始 腐 坏 。 


1 





整洁 的 测试 有 什么 要 素 ? 有 三 个 要 素 : Re 
| — egene 测试 如 何 才能 做 到 可 读 ez ? 和 其 他 代码 中 一 样 : 
RH Ns He 在 测试 中 ， 你 要 以 尽 可 能 少 的 文字 表达 大 量 内 容 。 

“来 看 看 代码 清 表单 9-1 中 来 自 FitNesse 的 代码 。 这 三 个 测试 很 难 读 懂 ， 显 然 有 改善 空间 。 
首先 ， 其 中 有 数量 恐怖 的 重复 代码 [G5] 调 用 addPage 和 assertSubString。 更 重要 的 是 ， 代码 中 
充满 了 干扰 测试 表达 力 的 细节 。 


代码 清单 9-1 SerializedPageResponderTest.java 


public void testGetPageHieratchyAsXml() throws Exception 

{ 
crawler.addPage(root, PathParser.parse("PageOne")); 
crawler.addPage(root, PathParser.parse("PageOne.ChildOne")); 
crawler.addPage(root, PathParser.parse("PageTwo")); 


9.3 整洁 的 测试 
SÉ. 。 在 单元 测试 中 ， 可 读 








request.setResource ("root"); 
request.addInput("type", "pages"); 
Responder responder - new Se 
SimpleResponse response = 
(SimpleResponse) responder.makeResponse( 
new FitNesseContext(root), request); 
String xml = response.getContent,(); 


assertEquals("text/xml", response.getContentType()); 
assertSubString ("<name>PageOne</name>", xml); 
assertSubString ("<name>PageTwo</name>", xml) ; 
assertSubString("<name>ChildOne</name>", xml); 

} 


public void testGetPageHieratchyAsXmlDoesntContainSymbolicLinks() 

throws Exception 

( 
WikiPage pageOne = crawler.addPage(root, PathParser.parse("PageOne")); 
crawler.addPage(root, PathParser.parse("PageOne.ChildOne")); 
crawler.addPage(root, PathParser.parse("PageTwo")); 
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PageData data = pageOne.getData(); 

WikiPageProperties properties - data. getProperties(); 

WikiPageProperty symLinks = properties.set(SymbolicPage.PROPERTY NAME); 
symLinks.set("SymPage", "PageTwo"); 

pageOne.cornimit (data); 


request.setResource ("root"); 
request.addInput ("type", "pages"); 
Responder responder = new SerializedPageResponder () ; 
SimpleResponse response = 
(SimpleResponse) responder.makeResponse ( 
new FitNesseContext (root), request); 
String xml = response.getContent (); 


assertEquals ("text/xml", response.getContentType()); 
assertSubString ("<name>PageOne</name>", xml); 
assertSubString ("<name>PageTwo</name>", xml); 
assertSubString ("<name>ChildOne</name>", xml); 
assertNotSubString ("SymPage", xml); 

} . 


public void testGetDataAsHtml() throws Exception 
{ 


crawler .addPage (root, PathParser.parse("TestPageOne"), "test page"); 


request.setResource ("TestPageOne") ; 
request.addInput ("type", "data"); 
Responder responder - new SE EES EE 
SimpleResponse response = 
(SimpleResponse) responder.makeResponse( 
new FitNesseContext(root), request); 
String xml = response.getContent(); 


assertEquals ("text/xml", response.getContentType()); 
assertSubString("test page", xml); 
assertSubString("«Test", xml); 


} 

请 看 对 PathParser 的 那些 调用 。 它 们 将 字符 串 转 换 为 供 仆 虫 使 用 的 PagePath 实体 。 转 换 
与 测试 毫 无 关系 ,徒然 混 诡 了 代码 的 意图 。 与 创建 responder 相关 的 细节 ， 还 有 response 的 收 
集 与 转换 也 尽 是 噪声 。 此 外 还 有 从 resource 和 参数 构造 请 求 URL 的 笨 手 段 。( 这 些 代码 我 有 
幸 参 与 编写 ， 所 以 可 以 敞开 来 批评 。) 

最 终 ， 这 段 代 码 不 是 设计 来 给 人 看 的 。 可 怜 的 读者 尖 没 在 细节 的 汪洋 大 海中 ， 在 真正 用 
到 测试 之 前 ， 还 得 理解 这 些 细节 。 

现在 看 看 代码 清单 9-2 中 改进 了 的 测试 。 这 些 测试 还 是 做 一 样 的 事 ， 不 过 已 经 被 重 构 为 
更 整洁 和 有 表达 力 的 形式 。 


代码 清单 9-2 SerializedPageResponderTestjava (M+R) 
public void testGetPageHierarchyAsXml() throws Exception { 
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makePages ("PageOne", "PageOne.ChildOne", "PageTwo"); 


E 


submitRequest("root", "type:pages"); 


assertResponseISsXML(); 
assertResponseContains( | 
"<name>PageOne</name>", "<name>PageTwo</name>", "<name>ChildOne</name>" 
); | 
) 


public void PE c ger throws Exception ( 
WikiPage page = makePage ("PageOne"); 
makePages ("PageOne.ChildOne", "PageTwo"); 


addLinkTo(page, "PageTwo", "SymPage"); 
submitRequest("root", "type:pages"); 


assertResponseIsXML(); 
assertResponseContains( 
"«name»PageOne«/name»", "«name»PageTwo«/name»", "<name>ChildOne</name>" 
); 
assertResponseDoesNotContain("SymPage"); 


) 


public void testGetDataAsXml() throws Exception | 
makePageWithContent("TestPageOne", "test page"); 


submitRequest ("TestPageOne", "type:data"); 


assertResponseIsXML(); 
assertResponseContains("test page", "«Test"); 


} 


这 些 测试 显然 呈现 了 构造 -操作 -检验 (BUILD-OPERATE-CHECK) ! 模 式 。 每 个 测试 都 清 
晰 地 拆 分 为 三 个 环节 。 第 一 个 环 DEES 第 二 个 环节 操作 测试 数据 ， 第 三 个 部 分 检 
验 操 作 是 否 得 到 期 望 的 结果 。 | 

注意 ， 那些 恼人 的 细节 大 部 分 消失 了 。 测试 直达 目的 ， 只 用 到 那些 真正 需要 的 数据 类 型 
和 函数 。 读 测试 的 人 应 该 都 能 够 很 快 搞 清楚 状况 ， 不 至 于 被 细节 误导 或 吓 倒 。 


93.1 面向 特定 领域 的 测试 语言 


代码 清单 9-2 中 的 测试 展示 了 为 测试 构造 一 种 面向 特定 领域 的 语言 的 技巧 。 我 们 没有 直 
接 使 用 程序 员 用 来 对 系统 进行 操作 的 APL, 而 是 打造 了 一 套 包装 这 些 APT 的 函数 和 工具 代码 ， 
这 样 就 能 更 方便 地 编写 测试 ， 写 出 来 的 测试 也 更 便于 阅读 。 那 正 是 一 种 测试 语言 ， 可 以 帮助 


' 原 注 : http://fitnesse.org/FitNesse.AcceptanceTestPatterns。 
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程序 员 编写 自己 的 测试 ， 也 可 以 帮助 后 来 者 阅读 测试 。 

这 种 测试 API 并 非 起 初 就 设计 出 来 ， 而 是 在 对 那些 充满 令 人 迷惑 细节 的 测试 代码 进行 后 
续 重 构 时 逐渐 演进 。 如 同 你 看 见 我 将 代码 清单 9-1 重 构 为 代码 清单 9-2 一 般 ， 守 规矩 的 开发 
者 也 将 他 们 的 测试 代码 重 构 为 更 简洁 和 具有 表达 力 的 形式 。 


9.3 忆 双重 标准 


在 茶 种 意义 上 ， 本 章 开 始 处 提 到 的 那个 团队 的 做 法 是 正确 的 。 测 试 API 中 的 代码 与 生产 代 
码 相 比 ， 的 确 有 一 套 不 同 的 工程 标准 。 测 试 代 码 应 当 简单 、 精 悍 、 足 具 表 达 力 ， 但 它 该 和 生产 
代码 一 般 有 效 。 毕 竟 它 是 在 测试 环境 而 非 生产 环境 中 运行 ， 这 两 种 环境 有 着 截然 不 同 的 需求 。 

请 看 代码 清单 9-3 中 的 测试 。 在 为 茶 个 环境 控制 系统 设计 原型 时 ， 我 写 了 这 个 测试 。 无 
需 深入 细节 ， 你 就 能 说 出 该 测试 在 “温度 太 低 ” 时 检验 温度 警报 器 、 加 热 器 和 送 风 机 是 否 全 
部 打开 。 


代码 清单 9-3 EnvironmentControllerTest.java 


@Test 
public void turnOnLoTempAlarmAtThreashold() throws Exception { 

hw.setTemp (WAY_TOO_COLD) ; 

controller.tic(); 

assertTrue (hw.heaterState()); 

assertTrue (hw.blowerState()); 

assertFalse(hw.coolerState()); 
assertFalse (hw. hiTempAlarm()); 

assertTrue (hw. loTempAlarm () ) ; 


} 


当然 ， 这 里 头 也 有 许多 细节 。 例 如 ，tic 函数 是 做 什么 的 ? 实际 上 ， 在 读 测试 时 你 可 以 不 
用 担心 这 些 问题 。 你 只 需 考虑 是 否 同意 系统 最 终 状态 是 否 与 “温度 太 低 ” 的 情况 相符 。 

当 你 阅读 这 个 测试 时 , 可 以 留意 到 自己 的 眼光 得 在 被 检验 的 状态 的 名 称 与 状态 的 “意义 ” 
之 间 来 回 跳 转 。 你 看 到 heaterState， 眼 光 同 左 滑 到 assertTrue。 你 看 到 coolerState， 有 眼光 向 左 
看 assertFalse。 这 个 过 程 既 乏味 又 不 可 靠 。 它 让 测试 变 得 难以 阅读 。 

我 大 幅 改 进 了 测试 的 可 读 性 ， 得 到 代码 清单 9-4。 


代码 清单 9-4  EnvironmentControllerTest.java (EHF) 


Biest 
public void turnOnLoTempAlarmAtThreshold() throws Exception { 
wayTooCold() ;’ 
assertEquals("HBchL", hw.getState()); 


当然 ， 我 创建 了 一 个 wayTooCold 函数 ， 隐 藏 了 tic 函数 的 细节 。 不 过 要 注意 的 是 
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assertEquals 中 的 那个 奇怪 的 字符 串 。 大 写 表 示 “ 打 开 ”， 小 写 表示 “关闭 ”那些 字符 遵循 以 


下 次 序 : {heater, blower, cooler, hi-temp-alarm, lo-temp-alarm) o 
尽管 这 破坏 了 思维 映射 的 规则 ， 看 来 它 在 这 种 情况 下 还 是 适用 的 。 只 要 你 明白 其 含义 ， 
你 就 能 一 眼看 到 那个 字符 串 ， 迅 速 译 解 出 结果 。 


代码 清单 9-5 EnvironmentControllerTestjava (扩展 到 更 大 范围 ) 


GTest 
public void turnOnCoolerAndBlowerIfTooHot() throws Exception { 

tooHot () ; | 

assertEquals ("hBChl", hw.getState()); 

} ) | 

@Test 

public void turnOnHeaterAndBlowerIfTooCold() throws Exception { 
tooCold(); 


assertEquals("HBchl", hw.getState()); 
) 


QTest 

public void CUTADH TEMPA La TMATTNTESRO LAN) throws Exception { 
wayTooHot () ; 
assertEquals ("hBCHl", hw.getState()); 

) 


QTest 

public void turnOnLoTempAlarmAtThreshold() throws Exception { 
wayTooCold(); 
assertEquals ("HBchL", hw.getState()); 


) 
代码 清单 9-6 中 给 出 了 getState RIA. JER, 代码 效率 不 是 非常 高 。 要 提升 效率 ， 可 能 
应 该 使 用 StringBuffer。 


代码 清单 9-6 MockControlHardware.java 
public String getState() { 


String state - ""; 

state += heater ? "H" ; "n"; 

state += blower ? "B" : "b"; 

State += cooler ? "C" ; "c"; 
state += hiTempAlarm ? "H" ; "h"; 

State += loTempAlarm ? "L" : "1"; 


return state; 


) 


StringBuffer 有 点 丑陋 。 即 便 在 生产 代码 中 , 假使 代价 较 小 , 我 都 会 避免 使 用 StringBuffer; 
而 且 你 可 以 看 到 ， 清 单 9-6 中 代码 的 代价 的 确 很 小 。 这 套 应 用 显然 是 嵌入 式 实时 系统 ， 计 算 
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机 和 内 存 资源 都 很 有 限 。 不 过 ， 测 试 环 境 大 概 完全 不 必 做 限制 。 
这 就 是 双重 标准 。 有 些 事 你 大 概 永 远 不 会 在 生产 环境 中 做 ， 而 在 测试 环境 中 做 却 完全 没 
问题 。 通 常 这 关乎 内 存 或 CPU 效率 的 问题 ， 不 过 却 永远 不 会 与 整洁 有 关 。 


94 每 个 测试 一 个 断言 


有 个 流派 认为 ，JUnit 中 每 个 测试 函数 都 应 该 有 且 只 有 一 个 断言 语句 。 这 条 规则 看 似 过 
于 苛求 ， 但 其 好 处 却 可 以 在 代码 清单 9-5 中 看 到 。 这 些 测 试 都 归结 为 一 个 可 快速 方便 地 理解 
的 结论 。 | 

代码 清单 9-2 又 如 何 ? 我 们 能 将 关于 输出 是 XML 的 断言 与 输出 包含 某 些 子 字符 串 的 断 
言 轻易 地 组 合 到 一 起 ， 不 过 这 样 做 看 来 毫 无 道理 。 然 而 ， 我 们 可 以 将 测试 分 解 为 两 个 单独 的 
测试 ， 每 个 都 有 自己 的 断言 ， 如 代码 清单 9-7 所 示 。 

代码 清单 9-7 SerializedPageResponderTest.java (单个 断言 的 版 本 ) 

public void testGetPageHierarchyAsXml() throws Exception { 

givenPages ("PageOne", "PageOne.ChildOne", "PageTwo"); 


whenRequestIsIssued("root", "type:pages"); 


thenResponseShouldBeXML(); 
) 


public void testGetPageHierarchyHasRightTags() throws Exception { 
givenPages("PageOne", "PageOne.ChildOne", "PageTwo"); 


whenRequestIsIssued("root", "type:pages"); 


thenResponseShouldContain ( 
"<name>PageOne</name>", "<name>PageTwo</name>", "<name>ChildOne</name>" 
); i 
ee 
注意 ， 我 修改 了 那些 函数 的 名 称 ， 以 符合 given-when-then“ 约 定 。 这 让 测试 更 易 阅 读 。 不 
FKE, WR, SATS BSB WE. 
可 以 利用 模板 方法 (TEMPLATE METHOD) ?模式 ， 将 given/when 部 分 放 到 基 类 中 ， 
将 then 部 分 放 到 派生 类 中 ， 消 除 代 码 重复 问题 。 或 者 ， 我 们 也 可 以 创建 一 个 完整 的 单独 
测试 类 , 把 given 和 when 部 分 放 到 @Before MAF, 把 when 部 分 放 到 每 个 @Test 函数 中 。 
但 对 于 这 个 小 问题 ， 这 看 来 有 点 太 机 械 。 最 后 ， 我 还 是 保留 了 代码 清单 9-2 那 种 多 个 断言 


' Jit: MN Dave Astel 的 blog 文章 : http://www.artima.com/weblogs/viewpost.jsp?thread=35578。 
2 JRYE: [RSpec]. | 
? RYE: [GOF]. 


122 第 9 章 单元 测试 ` 


的 形式 。 2E m 
我 认为 ， 单 个 断言 是 个 好 准则 !。 我 通常 都 会 创建 支持 这 条 准则 的 特定 领域 测试 语言 ， 如 
代码 清单 9-5 所 示 。 不 过 ， 我 也 不 害怕 在 单个 测试 中 放 入 一 个 以 上 断言 4 我 认为 ， 最 好 的 说 
法 是 单个 测试 中 的 断言 数量 应 该 最 小 化 。 


每 个 测试 一 个 概念 


更 好 一 些 的 规则 或 许 是 每 个 测试 函数 中 只 测试 一 个 概念 。 我 们 不 想 要 超 长 的 测试 函数 ， 
测试 完 这 个 又 测试 那个 。 代 码 清单 9-8 就 是 那样 一 种 测试 的 例子 。 这 个 测试 应 当 拆 解 为 3 个 
单独 测试 ， 因 为 它 测试 了 3 件 不 同 的 事 。 把 三 者 混 到 一 起 ， 读 者 就 不 得 不 猜想 每 段 代码 出 现 
的 理由 ， 以 及 那 段 代码 到 底 要 测试 什么 。 | | 


代码 清单 9-8 
/** 
* Miscellaneous tests for the addMonths() method. 
d | 
public void testAddMonths() { 
SerialDate dl = SerialDate.createInstance(31, 5, 2004); 


SerialDate d2 = SerialDate.addMonths (1, dl); 
assertEquals(30, d2.getDayOfMonth()); 
assertEquals(6, d2.getMonth()); 

assertEquals (2004, d2.getYYYY()); 


SerialDate d3 = SerialDate.addMonths (2, dl); 
assertEquals(31, d3.getDayOfMonth()); 
assertEquals(7, d3.getMonth()); 
assertEquals (2004, d3.getYYYY ()); 


SerialDate d4 = SerialDate.addMonths(1, SerialDate.addMonths(1, d1)); 
assertEquals(30, d4.getDayOfMonth()); 

assertEquals(7, d4.getMonth()); 

assertEquals (2004, d4.getYYYY()); 


这 三 个 测试 函数 大 概 应 该 像 这 个 样子 : 
rv ”对 于 某 个 有 31 天 的 月 份 的 最 后 一 天 “如 五 月 ): 

CD 增加 一 个 该 月 份 最 末 一 天 为 30 日 (如 六 月 ) 的 月 份 时 ， 日 期 应 该 是 该 月 的 30 日 而 
JE3LES 

(2) 增加 最 末 月 有 31 天 的 两 个 月 时 ， 日 期 应 该 是 31 Ho 

。 ”对 于 某 个 有 30 天 的 月 份 的 最 后 一 天 如 六 月 );: 

(3) 增加 一 个 有 31 天 的 月 份 时 ， 日 期 应 该 是 30 日 而 非 31 H, 


” 原 注 : “ 照 规矩 办 (Keep to the code) !”【 译 者 按 】 这 是 电影 《加 勒 比 海盗 》 中 的 一 句 台 词 。 
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这 样 一 来 ,你 可 以 看 到 ， 在 这 些 混杂 的 测试 当中 ,隐藏 有 一 条 普遍 规则 。 增 加 月 份 数 时 ， 
日 期 不 能 大 于 该 月 份 的 最 末 一 天 。 这 意味 着 在 2 月 28 日 增加 月 份 数 ， 就 会 得 到 3 月 28 日 。 
而 这 个 测试 应 该 有 用 ， 但 被 遗漏 了 。 

并 非 是 代码 清单 9-8 中 每 个 段落 的 多 重 断 言 导 致 问题 。 问 题 在 于 ， 有 多 个 概念 被 测试 ， 
所 以 , 最 佳 规则 也 许 是 应 该 尽 可 能 减少 每 个 概念 的 断言 数量 , 每 个 测试 函数 只 测试 一 个 概念 。 


9.5 FIRST 


整洁 的 测试 还 遵循 以 下 $ 条 规则 ， 这 5 条 规则 的 首 字母 构成 了 本 节 标 题 ， 

(Ri (Fast) 测试 应 该 够 快 。 测 试 应 该 能 快速 运行 。 测 试 运行 缓慢 ， 你 就 不 会 想 要 频繁 
地 运行 它 。 如 果 你 不 频繁 运行 测试 ， 就 不 能 尽早 发 现 问题 ， 也 无 法 轻易 修正 ， 从 而 也 不 能 轻 
”而 易 举 地 清理 代码 。 最 终 ， 代 码 就 会 腐 坏 。 

独立 (Independent) 测试 应 该 相互 独立 。 某 个 测试 不 应 为 下 一 个 测试 设 定 条件 。 你 应 该 
可 以 单独 运行 每 个 测试 ， 及 以 任何 顺序 运行 测试 。 当 测试 互相 依赖 时 ， 头 一 个 没 通过 就 会 导 
致 一 连 串 的 测试 失败 ， 使 问题 诊断 变 得 困难 ， 隐 藏 了 下 级 错误 。 

可 重复 (Repeatable) 测试 应 当 可 在 任何 环境 中 重复 通过 。 你 应 该 能 够 在 生产 环境 、 质 
检 环 境 中 运行 测试 ， 也 能 够 在 无 网 络 的 列车 上 用 笔记 本 电脑 运行 测试 。 如 果 测 试 不 能 在 任 
意 环境 中 重复 ， 你 就 总 会 有 个 解释 其 失败 的 接口 。 当 环境 条 件 不 具备 时 ， 你 也 会 无 法 运行 
测试 。 | | 

目 足 验证 〈Self-Validating) 测试 应 该 有 布尔 值 输出 。 无 论 是 通过 或 失败 ， 你 不 应 该 查看 日 
志文 件 来 确认 测试 是 否 通过 。 你 不 应 该 手工 对 比 两 个 不 同文 本 文件 来 确认 测试 是 否 通过 。 如 果 测 
试 不 能 自足 验证 ， 对 失败 的 判断 就 会 变 得 依赖 主观 ， 而 运行 测试 也 需要 更 长 的 手工 操作 时 间 。 

RA (Timely) 测试 应 及 时 编写 。 单 元 测试 应 该 恰好 在 使 其 通过 的 生产 代码 之 前 编写 。 
如 果 在 编写 生产 代码 之 后 编写 测试 ， 你 会 发 现 生 产 代 码 难 以 测试 。 你 可 能 会 认为 某 些 生产 代 
码 本 和 喘 难 以 测试 。 你 可 能 不 会 去 设计 可 测试 的 代码 。 


9.6 “小结 


我 们 只 是 触及 了 这 个 话题 的 表面 。 实 际 上 ， 我 认为 应 该 为 整洁 的 测试 写 上 一 整 本 书 。 对 
于 项 目的 健康 度 ， 测 试 盒 生 产 代码 同等 重要 。 或 许 测试 更 为 重要 ， 因 为 它 保 证 和 增强 了 生产 
代码 的 可 扩展 性 、 可 维护 性 和 可 复 用 性 。 所 以 ， 保 持 测试 整洁 吧 。 让 测试 具有 表达 力 并 短小 
精怪。 发 明 作为 面向 特定 领域 语言 的 测试 API， 帮 助 自己 编写 测试 。 


' 原 注 : 参见 Object Mentor 培训 材料 。 
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如 果 你 坐视 测试 腐 坏 ， 那 么 代码 也 会 跟着 腐 坏 。 保 持 测试 整洁 吧 。 
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本 书 到 目前 为 止 一 直 在 讨论 如 何 编写 良好 的 代码 行 和 代码 块 。 我 们 深入 研究 了 函数 的 
恰当 构成 ， 以 及 函数 之 间 如 何 互 相关 联 。 不 过 ， 尽 管 讨论 了 这 么 多 关于 代码 语句 及 由 代码 
语句 构成 的 函数 的 表达 力 ， 除 非 我 们 将 注意 力 放 到 代码 组 织 的 更 高 层面 ， 就 始终 不 能 得 到 
整洁 的 代码 。 
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10.1 ”类 的 组 织 


遵循 标准 的 Java 约定 , 类 应 该 从 一 组 变量 列表 开始 。 如 果 有 公共 静态 常量 , 应 该 先 出 现 。 
然后 是 私有 静态 变量 ， 以 及 私有 实体 变量 。 很 少 会 有 公共 变量 。 0 ; 

公共 函数 应 跟 在 变量 列表 之 后 。 我 们 喜欢 把 由 某 个 公共 函数 调用 的 私有 工具 函数 紧 随 在 
该 公共 函数 后 面 。 这 符合 了 自 项 向 下 原则 ， 让 程序 读 起 来 就 像 一 篇 报纸 文章 。 


封装 


我 们 喜欢 保持 变量 和 工具 函数 的 私有 性 ， 但 并 不 执着 于 此 。 有 时 ， 我 们 也 需要 用 到 受 护 
(protected) 变量 或 工具 函数 ， 好 让 测试 可 以 访问 到 。 对 我 们 来 说 ， 测 试 说 了 算 。 若 同一 程序 
包 内 的 某 个 测试 需要 调用 一 个 函数 或 变量 ， 我 们 就 会 将 该 函数 或 变量 置 为 受 护 或 在 整个 程序 
包 内 可 访问 。 然 而 ， 我 们 首先 会 想 办 法 使 之 保有 隐私 。 放 松 封装 总 是 下 和 集 。 


10.2. ”类 应 该 短小 


关于 类 的 第 一 条 规则 是 类 应 该 短小 。 第 二 条 规则 是 还 要 更 短小 。 不 ， 我 们 并 不 是 要 重 弹 
“函数 ”一 章 的 论调 。 就 像 函 数 一 样 ， 在 设计 类 时 ， 首要 规 条 束 是 要 更 短小 。 和 函数 一 样 ， 马 
上 有 个 问题 出 现 ， 那 就 是 “多 小 合适 呢 ? ” 

对 于 函数 ， 我 们 通过 计算 代码 行 数 衡量 大 小 。 对 于 类 ， 我 们 采用 不 同 的 衡量 方法 ， 计 算 
权 责 (responsibility) `. 

代码 清单 10-1 给 出 了 某 个 类 的 轮廓 。SuperDashboard 类 曝露 大 概 70 个 公共 方法 ， 大 多 
数 开发 者 都 会 同意 , 这 实在 是 太 长 了 。 有 些 开 发 者 或 许 会 将 SuperDashboard 类 指 为 “ 神 的 类 ”。 


代码 清单 10-1 MAAS 


public class SuperDashboard extends JFrame implements MetaDataUser 
public String getCustomizerLanguagePath() 
public void setSystemConfigPath(String systemConfigPath) 
public String getSystemConfigDocument () 
public void setSystemConfigDocument (String systemConfigDocument) 
public boolean getGuruState() 
public boolean getNoviceState() 
public boolean getOpenSourceState () 
public void showObject (MetaObject object) 


! AYE: [RDD]. 
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public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
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void showProgress(String s) 

boolean isMetadataDirty () 

void setIsMetadataDirty(boolean isMetadataDirty) 
Component getLastFocusedComponent () 

void setLastFocused(Component lastFocused) | 
void setMouseSelectState (boolean EEN 
boolean isMouseSelected() 

LanguageManager getLanguageManager () 

Project getProject() 

Project getFirstProject() 

Project getLastProject() 

String getNewProjectName () l 

void setComponentSizes (Dimension dim) 

String getCurrentDir() 

void setCurrentDir(String newDir) 

void updateStatus(int dotPos, int markPos) 
Class[] getDataBaseClasses () 

MetadataFeeder getMetadataFeeder () 


void addProject(Project project) 


boolean setCurrentProject (Project project) 

boolean removeProject (Project project) 
MetaProjectHeader getProgramMetadata () 

void resetDashboard() 

Project loadProject(String fileName, String SCENE 
void setCanSaveMetadata (boolean canSave) 


MetaObject getSelectedObject () 


void deselectObjects () 

void setProject (Project project) 

void editorAction(String actionName, ActionEvent event) 
void setMode (int mode) 

FileManager getFileManager () 

void setFileManager(FileManager fileManager) 
ConfigManager getConfigManager () 

void setConfigManager (ConfigManager configManager) 
ClassLoader getClassLoader () 

void setClassLoader (ClassLoader classLoader) 
Properties getProps () 

String getUserHome () 

String getBaseDir () 

int getMajorVersionNumber () 

int getMinorVersionNumber () 

int getBuildNumber () 

MetadObject pasting ( 


MetaObject target, MetaObject pasted, MetaProject project) 


public 
public 
public 
public 
public 
public 
public 
public 
public 
public 


void processMenuItems (MetaObject metaObject) 

Void processMenuSeparators (MetaObject metaObject) 
void processTabPages (MetaObject metaObject) 

void processPlacement (MetaObject object) 

void processCreateLayout (MetaObject object) 


void updateDisplayLayer (MetaObject object, int layerIndex) . 


void propertyEditedRepaint (MetaObject object) 

void processDeleteObject (MetaObject object) 

boolean getAttachedToDesigner () 

void processProjectChangedState (boolean hasProjectChang) 
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public void processObjectNameChanged (MetaObject object) 
public void runProject() 
public void setAcowDragging (boolean allowDragging) 
public boolean allowDragging() 
public boolean isCustomizing() 
public void setTitle(String title) 
public IdeMenuBar getIdeMenuBar () 
public void showHelper (MetaObject metaObject, String T ee 
// ... many non-public methods follow ... 
) 


如 果 SuperDashboard 类 只 包括 代码 清单 10-2 中 的 方法 呢 ? 
代码 清单 10-2 BBA Tw? 


public class SuperDashboard extends JFrame implements MetaDataUser( ! 

public Component getLastFocusedComponent () 
public void setLastFocused(Component lastFocused) 
public int getMajorVersionNumber () 

public int getMinorVersionNumber () 

public int getBuildNumber () - 

} 

5 个 方法 不 算 多 ， 在 这 里 ， 虽 然 方法 数量 较 少 ， 可 SuperDashboard 还 是 拥有 太 多 权 责 。 

类 的 名 称 应 当 描述 其 权 责 。 实 际 上 ， 命 名 正 是 帮助 判断 类 的 长 度 的 第 一 个 手段 。 如 果 无 
法 为 某 个 类 命 以 精确 的 名 称 ， 这 个 类 大 概 就 太 长 了 。 类 名 越 含 混 ， 该 类 越 有 可 能 拥有 过 多 权 
责 。 例 如 ， 如 果 类 名 中 包括 含义 模糊 的 词 ， 如 Processor 或 Manager 或 Super， 这 种 现象 往往 
说 明 有 不 恰当 的 权 责 聚集 情况 存在 。 

我 们 也 应 该 能 够 用 大 概 25 个 单词 简要 描述 一 个 类 ， 且 不 用 “ 若 GO. "E Cand)”. “R 
Cor)” 或 者 “但 (but)” 等 词汇 。 我 们 该 如 何 描述 SuperDashboard RHE? “SuperDashboard 
类 提供 了 对 最 后 拥有 焦点 的 组 件 的 访问 能 力 ， 我 们 还 能 通过 它 跟踪 版 本 号 和 构建 序列 号 。 
“还 能 ” 二 字 正 好 提示 了 SuperDashboard 类 有 太 多 权 责 。 


102.1 单一 权 责 原则 


单一 BUR E 则 (SRP) li Nj, s 2l E EU 4 SE RSA EE x PLTA | ia a .该 EJ JEA Ay 
了 权 责 的 定义 ， 又 是 关于 闫 的 长 度 的 指导 方针 。 关 只 应 有 一个 权 资 一 只 有 一 条 修改 的 理由 。 

代码 清单 10-2 中 貌似 很 小 的 SuperDashboard 类 有 两 条 加 以 修改 的 理由 。 首先 , CREK 
概 会 随 软件 每 次 发 布 而 更 新 的 版 本 信息 。 第 二 ， 它 管理 Java Swing 组 件 〈 派 生 自 JFrame, Ti 
层 GUI 窗口 的 Swing 表现 形态 )。 每 次 修改 Swing 代码 时 ， 无 疑 都 要 更 新 版 本 号 ， 但 反之 未 
必 可 行 : 也 可 能 依据 系统 中 其 他 代码 的 修改 而 更 新 版 本 信息 。 





! 原 注 : 你 可 在 [PPP] 中 读 到 更 多 信息 。 
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鉴别 权 责 (修改 的 理由 ) 常常 帮助 我 们 在 代码 中 认识 到 并 创建 出 更 好 的 抽象 。 可 以 轻易 
地 将 全 部 三 个 处 理 版 本 信息 的 SuperDashboard 方法 拆 解 到 名 为 Version 的 类 中 (如 代码 清单 
10-3 所 示 )。Version 类 是 个 极 有 可 能 在 其 他 应 用 程序 中 得 到 复 用 的 构造 ! 


代码 清单 10-3 单一 权 责 类 
. public class Version ( 
public int getMajorVersionNumber () 
` public int getMinorVersionNumber() . 
public int getBuildNumber() 

) | 

SRP 是 OO 设计 中 最 为 重要 的 概念 之 一 ， 也 是 较为 容易 理解 和 遵循 的 概念 之 一 。 奇 怪 的 是 
SRP 往往 也 是 最 容易 被 破坏 的 类 设计 原则 。 经 常会 遇 到 做 太 多 事 的 类 。 为 什么 呢 ? 

让 软件 能 工作 和 让 软件 保持 整洁 , 是 两 种 截然 不 同 的 工作 。 我 们 中 的 大 多 数 人 脑力 有 限 ， 
只 能 更 多 地 把 精力 放 在 让 代码 能 工作 上 , 而 不 是 放 在 保持 代码 有 组 织 和 整洁 上 。 这 全 然 正确 。 
分 而 治之 ， 其 在 编程 行为 中 的 重要 程度 等 同 于 在 程序 中 的 重要 程度 。 

问题 是 太 多 人 在 程序 能 工作 时 就 以 为 万 事 大 吉 了 .我们 没 能 把 思维 转向 有 关 代码 组 织 和 整洁 
的 部 分 。 我 们 直接 转向 下 一 个 问题 ， 而 不 是 回头 将 腾 肿 的 类 切 分 为 只 有 单一 权 责 的 去 耦 式 单元 。 

与 此 同时 ， 许 多 开发 者 害怕 数量 巨大 的 短小 单一 目的 类 会 导致 难以 一 目 了 然 抓 住 全 局 。 
他 们 认为 ， 要 搞 清楚 一 件 较 大 工作 如 何 完成 ， 就 得 在 类 与 类 之 间 找 来 找 去 。 

然而 ， 有 大 量 短小 类 的 系统 并 不 比 有 少量 庞大 类 的 系统 拥有 更 多 移动 部 件 ， 其 数量 大 致 
相等 。 问 题 是 : 你 是 想 把 工具 归 置 到 有 许多 抽 屠 、 每 个 抽 屠 中 装 有 定义 和 标记 良好 的 组 件 的 
工具 箱 中 呢 ， 还 是 想 要 少数 几 个 能 随便 把 所 有 东西 扔 进去 的 抽 履 ? 

每 个 达到 一 定 规模 的 系统 都 会 包括 大 量 逻 辑 和 复杂 性 。 管 理 这 种 复杂 性 的 首要 目标 就 是 加 以 
组 织 ， 以 便 开发 者 知道 到 哪儿 能 找到 东西 ， 并 且 在 某 个 特定 时 间 只 需要 理解 直接 有 关 的 复杂 性 。 
反之 ， 拥 有 巨大 、 chereng sarta Ke Reie ageet Dir Age 





类 应 该 只 有 少量 实体 变量 。 类 中 的 每 个 方法 都 应 该 操作 一 个 或 多 个 这 种 变量 。 通 常 而 言 ， 
方法 操作 的 变量 越 多 ， 就 越 茜 聚 到 类 上 。 如 果 一 个 类 中 的 每 个 变量 都 被 每 个 方法 所 使 用 ， 则 
该 类 具有 最 大 的 内 聚 性 。 

一 般 来 说 ， 创 建 这 种 极 大 化 内 聚 类 是 既 不 可 取 也 不 可 能 的 ， 另 一 方面 ， 我 们 希望 内 聚 性 
保持 在 较 高 位 置 。 内 聚 性 高 ， 意 味 着 类 中 的 方法 和 变量 互相 依赖 、 互 相 结合 成 一 个 逻辑 整体 。 

看 看 代码 清单 10-4 中 一 个 Stack 类 的 实现 方式 。 这 个 类 非常 内 聚 。 在 三 个 方法 中 ， 只 有 
size( ) 方 法 没有 使 用 所 有 两 个 变量 。 
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代码 清单 10-4 Stacklava (一 个 内 聚 类 ) 
public class Stack ( 
private int topOfStack = 0; ` 
List<Integer> elements = new LinkedList«Integer»(); 


public int size() { 
return topOfStack; 
) 


public void push(int element) ( 
topOfStacktt; 
elements.add(element) ; 

} i D 


public int pop() throws PoppedWhenEmpty { 
if (topOfStack == 0) 
. throw new PoppedWhenEmpty (); 
int element - elements.get(--topOfStack); 
elements.remove (topOfStack); 
return element; 
) 
) 


保持 函数 和 参数 列表 短小 的 策略 , 有 时 会 导致 为 一 组 子 集 方 法 所 用 的 实体 变量 数量 增加 。 
出 现 这 种 情况 时 ， 往 往 意味 着 至 少 有 一 个 类 要 从 大 类 中 挣扎 出 来 。 你 应 当 尝 试 将 这 些 变量 和 
方法 分 拆 到 两 个 或 多 个 类 中 ， 让 新 的 类 更 为 内 聚 。 | d x: 


1023 ”保持 内 聚 性 就 会 得 到 许多 短小 的 类 


仅仅 是 将 较 大 的 函数 切割 为 小 函数 ， 就 将 导致 更 多 的 类 出 现 。 想 想 看 一 个 有 许多 变量 的 
大 函数 。 你 想 把 该 函数 中 某 一 小 部 分 拆 解 成 单独 的 函数 。 不 过 ， 你 想 要 拆 出 来 的 代码 使 用 了 
该 函数 中 声明 的 4 个 变量 。 是 否 必须 将 这 4 个 变量 都 作为 参数 传递 到 新 函数 中 去 呢 ? 

完全 没 必要 ! 只 要 将 4 个 变量 提升 为 类 的 实体 变量 ， 完 全 无 需 苇 递 任何 变量 就 能 拆 解 代 
码 了 。 应 该 很 容易 将 函数 拆 分 为 小 块 。 l 

可 惜 这 也 意味 着 类 丧失 了 内 聚 性 ， 因 为 堆积 了 越 来 越 多 只 为 允许 少量 函数 共享 而 存在 的 
实体 变量 。 等 一 下 ! 如 果 有 些 函数 想 要 共享 某 些 变量 ， 为 什么 不 让 它们 拥有 自己 的 类 呢 ? 当 
类 丧失 了 内 聚 性 ， 就 拆 分 它 ! 

所 以 ， 将 大 函数 拆 为 许多 小 函数 ， 往 往 也 是 将 类 拆 分 为 多 个 小 类 的 时 机 。 程 序 会 更 加 有 
组 织 ， 也 会 拥有 更 为 透明 的 结构 。 

为 了 说 明 我 的 意思 , 不 如 从 Knuth 的 名 著 Literate Programming “中 译 版 《字面 编程 》)) ! 中 
摘 取 一 个 经 过 时 间 考 验 的 例子 。 代 码 清单 10-5 展示 了 Knuth 的 PrintPrimes 程序 的 Java 版 本 。 


! Bt: [Knuth92]. 
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为 示 公 平 ， 以 下 程序 并 非 Knuth 原版 ， 而 是 用 他 的 WEB 工具 输出 的 版 本 。 采 用 它 作为 例子 
的 目的 ， 是 因为 它 是 展示 如 何 将 较 大 的 函数 分 解 为 多 个 较 小 的 函数 和 类 的 极 好 入 手 点 。 


代码 清单 10-5 PrintPrimes.java 


package literatePrimes; 


public class PrintPrimes { 
public static void main(String[] args) ( 

final int M = 1000; 
final int RR 50; 
final int CC = 4; 
final int WW = 10; 
final int ORDMAX - 30; 
int P[] = new int[M + 1]; 
int PAGENUMBER; 
int PAGEOFFSET; 
int ROWOFFSET; 
int C; 
int J; 
int K; 
boolean JPRIME; 
int ORD; 
int SQUARE; 
int N; 
int MULT[] = new int[ORDMAX + 1]; 


J= 1; 

K = 1; 

P[1] = 2; 
ORD = 2; 
SQUARE = 9; 


while (K < M) { 
do { 
J =J +2; 
if (J == SQUARE) { 
ORD = ORD + 1; 
SQUARE = P[ORD] * P[ORD]; 
MULT[ORD - 1] = J; 
} 
N = 2; 
JPRIME = true; 
while (N < ORD && JPRIME) { 
while (MULT[N] < J) 
MULT[N] = MULT[N] + P[N] + P[N]; 
if (MULT[N] == J) 
JPRIME = false; 
N=N +1; 
} 
} while (!JPRIME); 
K=K +1; 
P(K] = J; 
} 
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{ 
PAGENUMBER = 1; 
PAGEOFFSET = 1; 
while (PAGEOFFSET <= M) { 
System.out.println("The First " * M * 
" Prime Numbers --- Page " * PAGENUMBER); 
System.out.println(""); 
for (ROWOFFSET = PAGEOFFSET; ROWOFFSET < PAGEOFFSET + RR; ROWOFFSET++) { 
for (C = 0; C < CC;C++) | 
if (ROWOFFSET + C * RR <= M) 
System.out.format("$10d", P[ROWOFFSET + C * RRJ); 
System.out.println(""); 
} 
System.out.printin("\£"); 
PAGENUMBER = PAGENUMBER + 1; 
PAGEOFFSET = PAGEOFFSET + RR * CC; 
} 
} 
} 
} 


该 程序 只 有 一 个 大 函数 ， 简 直 一 团 糟 。 它 拥有 很 深 的 缩 进 结构 ， 元 余 的 变量 和 紧密 耦合 
的 结构 。 至 少 应 该 将 其 拆 分 为 数 个 较 小 的 函数 。 

从 代码 清单 10-6 到 代码 清单 10-8， 展 示 了 将 代码 清单 10-5 中 的 代码 拆 分 为 较 小 的 类 和 
函数 ， 并 为 这 些 类 、 函 数 和 变量 取 个 好 名 字 后 的 结果 。 


代码 清单 10-6 PrimePrinter.java 〈 重 构 后 ) 


package literatePrimes; 


public class PrimePrinter ( 
public static void main(String[] args) ( 
final int NUMBER OF PRIMES = 1000; 
int[] primes = PrimeGenerator.generate (NUMBER OF. PRIMES); 


final int ROWS PER PAGE = 50; 
final int COLUMNS PER PAGE = 4; 
RowColumnPagePrinter tablePrinter - 
new RowColumnPagePrinter (ROWS PER PAGE, 
COLUMNS PER PAGE, 
"The First " + NUMBER OF PRIMES + 
| " Prime Numbers"); 
tablePrinter.print (primes); 





代码 清单 10-7 RowColumnPagePrinter.java 


package literatePrimes; 





import java.io.PrintStream; 


public class RowColumnPagePrinter { 
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private int rowsPerPage; 

private int columnsPerPage; 
private int numbersPerPage; 
private String pageHeader; 
private PrintStream printStream; 


public RowColumnPagePrinter(int rowsPerPage, 
int columnsPerPage, 
String pageHeader) { 
this.rowsPerPage = rowsPerPage; 
this.columnsPerPage - columnsPerPage; 
this.pageHeader = pageHeader; | 
numbersPerPage - rowsPerPage * columnsPerPage; 
printStream = System.out; 
) 


public void print(int data[]) { 
int pageNumber - 1; 
for (int firstIndexOnPage - 0; 
firstIndexOnPage « data.length; 
firstIndexOnPage += numbersPerPage) { 
int lastIndexOnPage - | 
Math.min(firstIndexOnPage * numbersPerPage - 1, 
data.length - 1); 
printPageHeader (pageHeader, pageNumber) ; 
printPage(firstIndexOnPage, lastIndexOnPage, data); 
printStream.println("\f"); 
pageNumbert*; 
) 
) 


private void printPage(int firstIndexOnPage, 
int lastIndexOnPage, 
int[] data) { 
int firstIndexOfLastRowOnPage - 
firstIndexOnPage + rowsPerPage - 1; 
for (int firstIndexInRow = firstIndexOnPage; 
firstIndexInRow <= firstIndexOfLastRowOnPage; 
firstIndexInRowt*) { 
printRow(firstIndexInRow, lastIndexOnPage, data); 
printStream.println(""); 
) 
) 


private void printRow(int firstIndexInRow,: 
int lastIndexOnPage, 
int[] data) ( 
for (int column = 0; column < columnsPerPage; column-**) { 
int index = firstIndexInRow + column * POWSPEEEAger 
if (index «- lastIndexOnPage) 
printStream.format("$10d", data[index]); 
) 
) 


private void printPageHeader(String pageHeader, 
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int pageNumber) ( 
printStream.println(pageHeader + " --- Page " + = pageNumber); 
printStream.println(""); 


) 


public void setOutput(PrintStream printStream) ( 
this.printStream = printStream; 
) 
) 





代码 清单 10-8 PrimeGenerator,j java 


package literatePrimes; 
import java.util.ArrayList; 


public class PrimeGenerator { 
private static int[] primes; | 
private static ArrayList<Integer> multiplesOfPrimeFactors; 


protected static int[] generate(int n) ( 
primes = new int[n]; 
multiplesOfPrimeFactors = new ArrayList<Integer>(); 
set2AsFirstPrime(); 
checkOddNumbersForSubsequentPrimes (); 
return primes; 


) 


private static void set2AsFirstPrime() ( 
primes[0] - 
multiplesOfPrimeFactors.add (2); 

) ` 


private static void checkOddNumbersForSubsequentPrimes() { 
int primeIndex - 1; 
for (int candidate = 3; 
primeIndex < primes.length; 
candidate += 2) ( 
if (isPrime (candidate)) 
primes[primeIndex**] = candidate; 
) 
) 


GE Static boolean isPrime(int candidate) { | 
if (isreastRelevautMultipleOfNextLargerPrinefqetor(candidate)) { 
multiplesOfPrimeFactors.add(candidate); 
return false; 
) 


return isNotMultipleOfAnyPreviousPrimeFactor (candidate); | 


) 


private static boolean 
isLeastRelevantMultipleOfNextLargerPrimeFactor (int candidate) ( 
int nextLargerPrimeFactor - primes [multiplesOfPrimeFactors.size()]; 
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int leastRelevantMultiple = nextLargerPrimeFactor * nextLargerPrimeFactor; 
return candidate -- leastRelevantMultiple; 


) 


private static boolean 
isNotMultipleOfAnyPreviousPrimeFactor(int candidate) ( 
for (int n = 1; n < multiplesOfPrimeFactors.size(); n++) { 
if (isMultipleOfNthPrimeFactor (candidate, n)) 
return false; 


) 


return true; 
} 


private static boolean 
isMultipleOfNthPrimeFactor(int candidate, int n) { 
return 
candidate == smallestOddNthMultipleNotLessThanCandidate (candidate, n); 


} 


private static int 
smallestOddNthMult ipleNotLessThanCandidate (int candidate, int n) { 
int multiple = multiplesOfPrimeFactors.get (n); 
while (multiple < candidate) 
multiple += 2 * primes[n]; 
. multiplesOfPrimeFactors.set(n, multiple); 
return multiple; 
) : 
} 
你 可 能 注意 到 的 第 一 件 事 就 是 程序 比 原来 长 了 许多 ， 从 1 页 多 增加 到 了 将 近 3 页 。 这 有 
几 个 原因 。 其 一 ， 重 构 后 的 程序 采用 了 更 长 、 更 有 描述 性 的 变量 名 。 其 二 ， 重 构 后 的 程序 将 
函数 和 类 声明 当 作 是 给 代码 添加 注释 的 一 种 手段 。 其 三 ， 我 们 采用 了 空格 和 格式 技巧 让 程序 
更 可 读 。 
留意 程序 是 如 何 被 拆 分 为 3 个 主要 权 责 的 。PrimePrinter 类 中 只 有 主 程序 。 主 程序 的 权 责 
是 处 理 执行 环境 。 如 果 调 用 方式 改变 ， 它 也 会 随 之 改变 。 例 如 ， 如 果 程 序 被 转换 为 SOAP HR 
务 ， 则 该 类 也 会 被 影响 到 。 
RowColumnPagePrinter 类 懂得 如 何 将 数字 列表 格式 化 到 有 着 固定 行 、 列 数 的 页 面 上 。 若 
输出 格式 需要 改动 ， 则 该 类 也 会 被 影响 到 。 
. PrimeGenerator 类 懂得 如 何 生成 素数 列表 。 注 意 ， 这 并 不 意味 着 要 实体 化 为 对 象 。 该 类 就 
是 个 有 用 的 作用 域 , 在 其 中 声明 并 隐藏 变量 。 如 果 计 算 素数 的 算法 发 生 改 动 , 则 该 类 也 会 改动 。 
这 并 不 算是 重 写 ! 我 们 没 从 头 开 始 写 一 遍 程 序 。 实 际 上 ， 如 果 你 仔细 看 上 述 两 个 不 同 的 
程序 ， 就 会 发 现 它们 采用 了 同样 的 算法 和 机 制 来 完成 工作 。 
我 们 通过 编写 验证 第 一 个 程序 的 精确 行为 的 用 例 来 实现 修改 。 然 后 ， 我 们 做 了 许多 小 改 
动 ， 每 次 改动 一 处 。 每 改动 一 次 ， 就 执行 一 次 ， 确 保 程序 的 行为 没有 变化 。 一 小 步 接着 一 小 
步 ， 第 一 个 程序 被 逐渐 清理 和 转换 为 第 二 个 程序 。 
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10.3 ”为 了 修改 而 组 织 


对 于 多 数 系统 ， 修 改 将 一 直 持续 。 每 处 修改 都 让 我 们 冒 着 系统 其 他 部 分 不 能 如 期 望 般 工 。 
作 的 风险 。 在 整洁 的 系统 中 ， 我 们 对 类 加 以 组 织 ， 以 降低 修改 的 风险 。 
代码 清单 10-9 中 的 Sql 类 用 来 生成 提供 恰当 元 数据 的 SQL 格式 化 字符 串 。 这 个 类 还 没 
写 完 ， 所 以 暂时 不 支持 update 语句 等 SQL 功能 。 当 需要 Sql 类 支持 update 语句 时 ， 我 们 就 
得 “打开 ”这 个 类 进行 修改 。 打 开 类 带 来 的 问题 是 风险 随 之 而 来 。 对 类 的 任何 修改 都 有 可 能 
破坏 类 中 的 其 他 代码 。 必 须 全 面 重新 测试 。 
代码 清单 0-9 ”一 个 必须 打开 修改 的 类 
public class Sql { 
public Sql (String table, Column[] columns) 
public String create() ` 
public String insert(Object[] fields) 
public String selectAll() ` 
public String findByKey(String keyColumn, String keyValue) 
public String select(Column column, String pattern) 
public String select(Criteria criteria) 
public String preparedInsert() 
private String columnList(Column[] columns) 
private String valuesList(Object[] fields, final Column[] S) 
private String selectWithCriteria(String criteria) 
private String placeholderList(Column[] columns) 


) 


当 增 加 一 种 新 语句 类 型 时 ， 就 要 修改 Sql 类 。 改 动 单 个 语句 类 型 时 ， 也 要 进行 修改 ， 比 
如 打算 让 select 功能 支持 子 查询 。 存 在 两 个 修改 的 理由 ， 说 明 Sql 违反 了 SRP 原则 。 

可 以 从 一 条 简单 的 组 织 性 观点 发 现 对 SRP 的 违反 。Sql 的 方法 大 纲 显示 ， 存 在 类 似 
selectWithCriteria 等 只 与 select 语句 有 关 的 私有 方法 。 | 

出 现 了 只 与 类 的 一 小 部 分 有 关 的 私有 方法 行为 ， 意 味 着 存在 改进 空间 。 然 而 ， 展 开行 动 
. 的 基本 动因 却 应 该 是 系统 的 变动 。 若 我 们 认为 Sql 类 在 逻辑 上 已 具足 ， 则 无 需 担 心 对 权 责 的 
拆 分 。 如 果 在 可 预见 的 未 来 无 需 增加 update 功能 ， 就 该 不 去 动 Sql 类 。 不 过 ， "BIZ, 
就 应 当 修 正 设 计 方 案 。 

代码 清单 10-10 中 的 解决 方式 如 何 呢 ? 代码 清单 10-9 中 Sql 类 的 每 个 接口 方法 都 重 构 到 
从 Sql 类 派生 出 来 的 类 中 了 。 注 意 那些 私有 方法 ， 如 valuesList， 直 接 移 到 了 需要 用 它们 的 地 
方 。 公 共 私 有 行为 被 划分 到 独立 的 两 个 工具 类 Where 和 ColumnList 中 。 

代码 清单 10-10 ”一 组 封闭 类 


abstract public class Sql { 
public Sql(String table, Column[] columns) 
abstract public String generate();- 
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) 


public class CreateSql extends Sql { - 

public CreateSql(String table, Column[] columns) 
@Override public String generate() 

} l | 


public class SelectSql extends Sql { 
public SelectSql(String table, Column[] columns) 
@Override public String generate() 

) 


public class InsertSql extends Sql { 
public InsertSql(String table, Column[] columns, Object[] fields) 
@Override public String generate() 
"| private String valuesList(Object[] fields, final Column[] columns) 
) 


public class SelectWithCriteriaSql extends Sql { 
| public SelectWithCriteriaSq] ( 
String table, Column[] columns, Criteria criteria) 
@Override public String generate() 
) . 


public class SelectWithMatchSql extends Sql { 
public SelectWithMatchSql( 
String table, Column[] columns, Column column, String pattern) 
@Override public String generate() | 
) 


public class FindByKeySql extends Sql{ 
public FindByKeySql( 
String table, Column[] columns, String keyColumn, String keyValue) 
@Override public String generate() 
) 


public class PreparedInsertSql extends Sql { 

public PreparedInsertSql(String table, Column(] columns) 
Override public String generate() { 

private String placeholderList(Column[] columns) 
} 


public class Where { 
public Where (String criteria) 
public String generate () 


) | l 

public class ColumnList { 
public ColumnList (Column[] columns) 
public String generate() 

) | 


每 个 类 中 的 代码 都 变 得 极为 简单 。 理 解 每 个 类 花费 的 时 间 缩减 到 近乎 为 零 。 函数 对 其 他 
孙 数 造成 毁坏 的 风险 也 变 得 几 近 于 无 。 从 测试 的 角度 看 ， 验 证 方案 中 每 一 处 逻辑 都 成 了 极为 
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简单 的 任务 ， 因 为 类 与 类 之 间 相互 隔离 了 。 

当 需 要 增加 update 语句 时 ， 现 存 类 无 需 做 任何 修改 ， 这 也 同等 重要 ! 我 们 在 Sql 类 的 新 
FR UpdateSql 中 构建 update 语句 的 逻辑 。 系统 中 的 其 他 代码 都 不 会 因为 这 个 修改 而 被 破坏 。 

重新 架构 的 Sql 逻辑 百 利 而 无 一 浆 。 它 支持 SRP。 它 也 支持 其 他 面向 对 象 设计 的 关键 原 
则 ， 如 开放 -闭合 原则 COCPO !， 类 应 当 对 扩展 开放 ， 对 修改 封闭 。 通 过 子 类 化 手段 ， 重 新 
架构 的 Sql 类 对 添加 新 功能 是 开放 的 ， VOTRE ISTE 只 要 将 UpdateSql 类 放 
置 到 位 就 行 了 。 

我 们 希望 将 系统 打造 成 在 添加 或 修改 特性 时 尽 可 能 少 惹 麻烦 的 架子 。 在 理想 系统 中 ， 我 
们 通过 扩展 系统 而 非 修改 现 有 代码 来 添加 新 特性 。 | 


隔离 修改 


需求 会 改变 ， 所 以 代码 也 会 改变 。 在 OO 101^rp, 我 们 学 习 到 ， 具体 类 包含 实现 细节 Ciy 
码 )， 而 抽象 类 则 只 呈现 概念 。 依 赖 于 具体 细节 的 客户 类 ， 当 细节 改变 时 ,就 会 有 风险 。 我 们 
可 以 借助 接口 和 抽象 类 来 隔离 这 些 细节 带 来 的 影响 。 

对 具体 细节 的 依赖 给 对 系统 的 测试 带 来 了 挑战 。 如 果 我 们 构建 一 个 依赖 于 外 部 
TokyoStockExchange API 的 Portfolio 类 ， 代 表 投 资 组 合 的 价值 ， 则 测试 用 例 就 会 受到 价值 查 
询 的 连带 影响 。 如 果 每 5 分 钟 就 有 新 说 法 ， 就 很 难 写 出 测试 来 。 

与 其 设计 直接 依赖 于 TokyoStockExchange 的 Portfolio 类 ,不 如 创建 StockExchange 接口 ， 
其 中 只 声明 一 个 方法 : 

public interface StockExchange ( 

Money currentPrice(String symbol); 

) 

我 们 设计 TokyoStockExchange 类 来 实现 这 个 接口 。 我们 还 要 确保 Portfolio 的 构造 器 接受 
作为 参数 的 StockExchange 引用 : 

public Portfolio { 

private StockExchange exchange; 

public Portfolio(StockExchange exchange) { 
this.exchange = exchange; 

Hos 

) | 

现在 就 可 以 为 StockExchange 接口 创建 可 测试 的 尝试 性 实现 了 。 该 尝试 性 实现 将 返回 固 
定 的 现 值 。 如 果 测 试 中 购买 了 5 股 微软 股票 ， 则 尝试 性 实现 总 是 返回 每 股 100 美元 的 现 值 。 
对 于 StockExchange 接口 的 尝试 性 实现 简化 为 简单 的 表格 查找 。 然 后 再 编写 一 个 总 投资 价值 


为 500 美元 的 测试 。 


! 原 注 : [PPP]. 
" PEE: 即 面向 对 象 入 门 知识 。 


10.4 文献 139 


public class PortfolioTest { 

private FixedStockExchangeStub exchange; 

private Portfolio portfolio; 

@Before 

protected void setUp() throws Exception { 
exchange = new ae ae eal ed 
exchange.fix("MSFT", 100); 
portfolio = new Portfolio(exchange) ; 


} 

QTest 

public void GivenFiveMSFTTotalShouldBe500() throws Exception { 
portfolio.add(5, "MSFT"); 
Assert.assertEquals(500, portfolio.value()); 


) 
] 


Di TR S ERES LURE, BRERA, BOA. REZI TN 
表 着 系统 中 的 元 素 互 相隔 离 得 很 好 。 陋 离 也 让 对 系统 每 个 元 素 的 理解 变 得 更 加 容易 。 
通过 降低 连接 度 ， 我 们 的 类 就 遵循 了 另 一 条 头 设计 原则 ， 依 赖 倒置 原则 (Dependency 
Inversion Principle, DIP) :。 本 质 而 言 ，DIP 认为 类 应 当 依赖 于 抽象 而 不 是 依赖 于 具体 细节 。 
我 们 的 Portfolio 类 不 再 依赖 于 TokyoStockExchange 类 的 实现 细节 ， 而 是 依赖 于 
StockExchange 接口 。StockExchange 接口 呈现 的 是 有 关 询 问 某 只 股票 价格 的 抽象 概念 。 这 种 
抽象 隔离 了 所 有 询 价 的 特定 细节 ， 包 括 价 格 数据 来 目 何 处 之 类 。 
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“复杂 要 人 命 。 它 消磨 开发 者 的 生命 ， 让 产品 难以 规划 、 构 建 和 测试 .” 
一 一 Ray Ozzie， 微 软 公 司 首席 技术 官 
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11.1 如 何 建造 一 个 城市 


”你 能 自己 掌管 一 切 细节 吗 ? 大 概 不 行 。 即 便 是 管理 一 个 既 存 的 城市 ， 也 是 一 个 人 无 法 做 ` 
到 的 。 不 过 ， 城 市 还 是 在 运转 〈 多 数 时 候 )。 因 为 每 个 城市 都 有 一 组 组 人 管理 不 同 的 部 分 ,， 供 : 
水 系统 、 供 电 系统 、 交 通 、 执 法 、 立 法 ， 诸 如 此 类 。 有 些 人 负责 全 局 ， 其 他 人 负责 细节 。 — 3 

城市 能 运转 ， 还 因为 它 演 化 出 恰当 的 抽象 等 级 和 模块 ， 好 让 个 人 和 他 们 所 管理 的 “组 件 ”: 
即便 在 不 了 解 全 局 时 也 能 有 效 地 运转 。 
尽管 软件 团队 往往 也 是 这 样 组 织 起 来 ， 但 他 们 所 致力 的 工作 却 常常 没有 同样 的 关注 面 切 | 
SRO EE: = a ere TUN 本 章 将 讨论 Eng 





11.2 ‘selene 


首先 ， 构 造 与 使 用 是 非常 不 一 样 的 过 程 。 当 我 走笔 至 此 ， 投 目 窗外 的 芝加哥 ， 看 到 有 





一 间 酒 店 正在 建设 。 今 天 ， 那 只 是 个 框架 结构 ， 起 重 机 和 升降 机 附着 在 外 面 。 忙 碌 的 人 们 . 


喘 穿 工作 服 ,， 头 戴 安全 帽 。 大 概 一 年 之 后 ,酒店 就 将 建成 。 起重机 和 升降 机 都 会 消失 无 踪 。 
建筑 物 变 得 整洁 ， 履 盖 着 玻璃 幕墙 和 漂亮 的 漆 色 。 在 其 中 工作 和 住宿 的 人 ， 会 看 到 完全 不 
同 的 景象 。 | 
软件 系统 应 将 启 始 过 程 和 启 始 过 程 之 后 的 运行 时 逻辑 分 离开 ， 在 启 始 过 程 中 构建 应 

用 对 象 ， 也 会 存在 互相 缠 结 的 依赖 关系 。 | 

每 个 应 用 程序 都 该 留意 启 始 过 程 。 那 也 是 本 章 中 我 们 首先 要 考虑 的 问题 。 将 关注 的 方面 
分 离开 ， 是 软件 技艺 中 最 古老 也 最 重要 的 设计 技巧 。 

不 幸 的 是 ， 多 数 应 用 程序 都 没有 做 分 离 处 理 。 启 始 过 程 代码 很 特殊 ， 被 混杂 到 运行 时 逻 
辑 中 。 下 例 就 是 典型 的 情形 : 

public Service getService() ( 

if (service == null) 
Service = new MyServiceImpl(...); // Good enough default for most cases? 


return service; 


) | 
这 就 是 所 谓 延 迟 初始 化 /赋值 ， 也 有 一 些 好 处 。 在 真正 用 到 对 象 之 前 ,无需 操心 这 种 架空 
构造 ， 启 始 时 间 也 会 更 短 ， 而 且 还 能 保证 永远 不 会 返回 null 值 。 

然而 ， 我 们 也 得 到 了 MyServiceImpl 及 其 构造 器 所 需 一 切 〈 我 省 略 了 那些 代码 ) 的 硬 编 
码 依赖 。 不 分 解 这 些 依 赖 关 系 就 无 法 编译 ， 即 便 在 运行 时 永 不 使 用 这 种 类 型 的 对 象 ! 
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如 果 MyServiceImpl 是 个 重型 对 象 ， 则 测试 也 会 是 个 问题 。 我 们 必须 确保 在 单元 测试 调用 
该 方法 之 前 ， 就 给 service 指派 恰当 的 测试 替身 (TEST DOUBLE) ! 或 仿制 对 象 (MOCK 
OBJECT)。 由 于 构造 还 辑 与 运行 过 程 相 混 杂 ， 我 们 必须 测试 所 有 的 执行 路 径 〈 例 如 ，null 值 测 
试 及 其 代码 块 )。 有 了 这 些 权 责 ， 说 明 方 法 做 了 不 止 一 件 事 ， 这 样 就 略微 违反 了 单一 权 责 原则 。 

最 糟糕 的 大 概 是 我 们 不 知道 MyServiceImpl 在 所 有 情形 中 是 否 都 是 正确 的 对 象 。 我 在 代 
码 注释 中 做 了 上 暗示。 为 什么 该 方法 所 属 类 必须 知道 全 局 情景 ? 我 们 是 否 真 能 知道 在 这 里 要 用 
到 的 正确 对 象 ? 是 否 真有 可 能 存在 一 种 放 之 四 海 而 缘 准 的 类 型 ? 

当然 ， 仅 出 现 一 次 的 延迟 初始 化 不 算是 严重 问题 。 不 过 ， 在 应 用 程序 中 往往 有 许多 种 类 
似 的 情况 出 现 。 于 是 ， 全 局 设置 策略 〈 如 果 有 的 话 ) 在 应 用 程序 中 四 散 分 布 ， 缺 乏 模块 组 织 
性 ， 通 常 也 会 有 许多 重复 代码 。 

如 果 我 们 勤 于 打造 有 着 良好 格式 并 且 强 固 的 系统 ， 就 不 该 让 这 类 就 手 小 技巧 破坏 模块 组 
织 性 。 对 象 构造 的 启 始 和 设置 过 程 也 不 例外 。 应 当 将 这 个 过 程 从 正常 的 运行 时 逻辑 中 分 离 出 
来 ， 确 保 拥 有 解决 主要 依赖 问题 的 全 局 性 一 贯 策略 。 


112.1 man 


将 构造 与 使 用 分 开 的 方法 之 一 是 将 全 部 构造 过 程 搬迁 到 main 或 被 称 之 为 main 的 模块 中 ， 
设计 系统 的 其 余部 分 时 ， 假 设 所 有 对 象 都 已 正确 构造 和 设置 (如 图 11-1 所 示 )。 | 

控制 流程 很 容易 理解 。main 函数 创建 系统 所 需 的 对 象 ， 再 传递 给 应 用 程序 ， 应 用 程序 只 
常 使用。 注意 看 横贯 main 与 应 用 程序 之 间隔 篇 的 依赖 箭头 的 方向 。 它 们 都 从 main 函数 向 外 
走 。 这 表示 应 用 程序 对 main 或 者 构造 过 程 一 无 所 知 。 它 只 是 简单 地 指望 一 切 已 齐备 。 


. co:Configured 
Object 


图 11-1 将 构造 分 解 到 main( ) 中 






1122 I] | 
当然 ， 有 时 应 用 程序 也 要 负责 确定 何 时 创建 对 象 。 比 如 ， 在 某 个 订单 处 理 系 统 中 ， 应 用 


' 原 注 : [Mezzaros07]。 
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程序 必须 创建 LineItem 实体 ， 添 加 到 Order 对 象 。 在 这 种 情况 下 ， 我 们 可 以 使 用 抽象 工厂 模 
式 ! 让 应 用 自行 控制 何 时 创建 LineItems， 但 构造 的 细节 却 隔离 于 应 用 程序 代码 之 外 。 | 










_ | LineltemFactory 
Implementation 


+makeLineltem 





<<creates>> 





图 11-2 ”使 用 工厂 分 离 构造 过 程 


再 留意 一 下 ， 所 有 依赖 都 是 从 main Jet OrderProcessing 应 用 程序 。 这 代表 应 用 程序 与 
如 何 构建 Lineltem 的 细节 是 分 离开 来 的 。 构 建 能 力 由 LineltemFactoryImplementation 持 有 ， 
而 LineItemFactoryImplementation 又 是 在 main 这 一 边 的 。 但 应 用 程序 能 完全 控制 Lineltem SE 
体 何 时 构建 ， 甚 至 能 传递 应 用 特定 的 构造 器 参数 。 


1123 依赖 注入 


有 一 种 强大 的 机 制 可 以 实现 分 离 构造 与 使 用 ， 那 就 是 依赖 注入 (Dependency Injection, 
DID, #4) 4 (Inversion of Control, loC) 在 依赖 管理 中 的 一 种 应 用 手段 ?。 控 制 反 转 将 第 
二 权 责 从 对 象 中 拿 出 来 ， 转 移 到 另 一 个 专注 于 此 的 对 象 中 ， 从 而 遵循 了 单一 权 责 原 则 。 在 依 
赖 管理 情景 中 , 对 和 象 不 应 负责 实体 化 对 自身 的 依赖 。 反之 , 它 应 当 将 这 份 权 责 移交 给 其 他 “有 
权力 ”的 机 制 ， 从 而 实现 控制 的 反 转 。 因 为 初始 设置 是 一 种 全 局 问题 ， 这 种 授权 机 制 通常 要 
么 是 main 例 程 ， 要 么 是 有 特定 目的 的 容器 。 

JNDI 查找 是 DI 的 一 种 “部 分 ”实现 。 在 JNDI 中 ， 对 象 请 求 目 录 服 务 器 提供 一 种 符合 
某 个 特定 名 称 的 “服务 ” 

MyService myService = (MyService) (jndiContext.lookup ("NameOfMyService") ); 

调用 对 象 并 不 控制 真正 返回 对 象 的 类 别 〈 当 然 前 提 是 它 实 现 了 恰当 的 接口 ), 但 调用 对 象 
仍然 主动 分 解 了 依赖 。 | 

真正 的 依赖 注入 还 要 更 进一步 。 类 并 不 直接 分 解 其 依赖 ， 而 是 完全 被 动 的 。 它 提供 


' YÈ: [GOF]. 
” 原 注 ， 可 参见 [Fowler]。 
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可 用 于 注入 依赖 的 赋值 器 方法 或 构造 器 参数 (或 二 者 名 有 )。 在 构造 过 程 中 ，DI 容器 实 
体 化 需要 的 对 象 〔 通 常 按 需 创建 )， 并 使 用 构造 器 参数 或 赋值 器 方法 将 依赖 连接 到 一 起 。 
至 于 哪个 依赖 对 象 真正 得 到 使 用 ， 是 通过 配置 文件 或 在 一 个 有 特殊 目的 的 构造 模块 中 纺 
程 决 定 。 

Spring 框架 提供 了 最 有 名 的 Java DI 容器 !。 用 户 在 XML 配置 文件 中 定义 互相 关联 的 对 
象 ， 然 后 用 Java 代码 请 求 特 定 的 对 象 。 稍 后 我 们 就 会 看 到 例子 。 | 

但 延 后 初始 化 的 好 处 是 什么 呢 ? 这 种 手段 在 DI 中 也 有 其 作用 。 首 先 ， 多 数 DI 容器 在 需 
要 对 象 之 前 并 不 构造 对 象 。 其 次 ， 许 多 这 类 容器 提供 调用 工厂 或 构造 代理 的 机 制 ， 而 这 种 机 
制 可 为 延迟 赋值 或 类 似 的 优化 处 理 所 用 2。 | 


11.3 扩容 


城市 由 城镇 而 来 ， 城 镇 由 聚居 而 来 。 一 开始 ， 道 路 狭窄 ， 几 乎 无 人 涉足 ， 随 后 逐渐 拓宽 。 
小 型 建筑 和 空地 渐渐 被 更 大 的 建筑 所 取代 ， 一 些 地 方 最 终 意 立 起 摩天 大 楼 。 

一 开始 ， 供 电 、 供 水 、 下 水 、 互 联网 OEN 等 服务 全 部 欠 奉 。 随 着 人 口 和 建筑 密度 的 增 
加 ， 这 些 服务 也 开始 出 现 。 

这 种 成 长 并 非 全 无 阵痛 。 你 有 多 少 次 开 着 车 ， 艰 难 穿行 过 一 个 “道路 改善 ”工程 ， 问 自 
己 ,“ 他 们 为 什么 不 一 开始 就 修 条 够 宽 的 路 昵 ? 1” 

不 过 那 无 论 如 何不 可 能 实现 。 谁 敢 打包 票 说 在 一 个 小 镇 修建 一 条 六 车道 的 公路 并 不 浪费 
呢 ? 谁 会 想 要 这 么 一 条 穿 过 他 们 小 镇 的 路 呢 ? 

“一 开始 就 做 对 系统 ” 纯 属 神话 。 反 之 ， 我 们 应 该 只 去 实现 今天 的 用 户 故事 ， 然 后 重 构 ， 
明天 再 扩展 系统 、 实 现 新 的 用 户 故事 。 这 就 是 迭代 和 增 量 敏捷 的 精髓 所 在 。 测 试 驱 动 开 发 、 
重 构 以 及 它们 打造 出 的 整洁 代码 ， 在 代码 层面 保证 了 这 个 过 程 的 实现 。 

但 在 系统 层面 又 如 何 ? 难道 系统 架构 不 需要 预先 做 好 计划 吗 ? 系统 理所当然 不 可 能 从 简 
单 递增 到 复杂 ， 它 能 行 吗 ? 

软件 系统 与 物理 系统 可 以 类 比 。 它 们 的 架构 都 可 以 递增 式 地 增长 ， 只 要 我 们 持续 将 
关注 面 恰当 地 切 分 。 

如 我 们 将 见 到 的 那样 ， 软 件 系统 短 生 命 周期 本 质 使 这 一 切 变 得 可 行 。 我 们 先 来 看 一 个 没 
有 充分 隔离 关注 问题 的 架构 反例 。 

初始 的 EJB1 和 EJB2 架构 没有 恰当 地 切 分 关注 面 ， 从 而 给 有 机 增长 压 上 了 不 必要 的 负担 。 
比如 一 个 持久 Bank 类 的 Entity Bean。Entity bean 是 关系 数据 在 内 存 中 的 体现 ， 换言之, RS 
格 的 一 行 。 


1! JAE: 见 [Spring]。 另 外 也 有 一 个 Spring.NET 框架 。 
” 原 注 ， 别 忘记 延迟 初始 化 /赋值 只 是 一 种 优化 手段 ， 而 且 可 能 是 一 种 不 成 熟 的 手段 。 
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首先 ， 你 要 定义 一 个 本 地 〈 进 程 内 ) 或 远程 (分 离 的 JVM) 接口 ， 供 客户 代码 使 用 。 代 


码 清单 11-1 就 是 一 种 可 能 的 本 地 接口 ; 


代码 清单 11-1 Bank EJB 的 EJB2 本 地 接口 


package com.example.banking; 
import java.util.Collections; 
import javax.ejb.*; 





public interface BankLocal extends java.ejb.EJBLocalObject { 
String getStreetAddrl() throws EJBException; 
String getStreetAddr2() throws EJBEXception; 
String getCity() throws EJBException; 
String getState() throws EJBException; 
String getZipCode() throws EJBException; 


void 
void 
void 
void 
void 


setStreetAddrl(String streetl) throws EJBException; 
setStreetAddr2(String street2) throws EJBException; 
setCity(String city) throws EJBException; 
setState(String state) throws EJBException; 
setZipCode (String zip) throws EJBException; 


Collection getAccounts() throws EJBException; 
void setAccounts (Collection accounts) throws EJBException; 


) 


void addAccount (AccountDTO accountDTO) throws EJBException; 


上 面 列 出 了 银行 地 址 的 几 个 属性 ， 和 一 组 该 银行 拥有 的 账户 ， 其 中 每 个 账户 的 数据 都 由 


单独 的 Account EJB 所 持 有 。 代 码 清单 11-2 展示 了 Bank bean 的 相应 实现 类 。 


代码 清单 11-2 ”相应 的 EJB2 Entity Bean 实现 


package com.example.banking; 
import java.util.Collections; 
import javax.ejb.*; 


public abstract class Bank implements javax.ejb.EntityBean { 


// 业务 逻辑 . . . 


public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 


InitialContext context - 
AccountHomeLocal accountHome = 


abstract 
abstract 
abstract 
abstract 
abstract 
abstract 
abstract 
abstract 
abstract 
abstract 
abstract 
abstract 


String getStreetAddrl(); 

String getStreetAddr2(); 

String getCity(); 

String getState(); 

String getZipCode(); 

void setStreetAddrl(String streetl); 
void setStreetAddr2 (String street2); 
void setCity(String city); 

void setState(String state); 

void setZipCode (String zip); 
Collection getAccounts(); 

void setAccounts (Collection accounts); 


void addAccount (AccountDTO accountDTO) { 


new InitialContext(); 
context. lookup ("AccountHomeLocal") ; 


AccountLocal account = accountHome.create (accountDTO) ; 
Collection accounts = getAccounts(); 
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accounts.add(account) ; 
} 
// EJB container logic 
public abstract void setId(Integer id); 
public abstract Integer getId(); ` 
public Integer ejbCreate(Integer id) ( ... ) 
public void ejbPostCreate(Integer id) ( ... ) 
// The rest had to be implemented but were usually empty: 
public void setEntityContext (EntityContext ctx) {} 
public void unsetEntityContext() {} 
public void ejbActivate() {} 
public void ejbPassivate() {} 
public void ejbLoad() {} 
public void ejbStore() {} 
public void ejbRemove() {} 
} 


我 没有 列 出 对 应 的 LocalHome 接口 ， 该 接口 基本 上 是 用 来 创建 对 象 的 ， 也 没有 列 出 你 可 
能 添加 的 Bank 查找 器 (查询 )。 | 

最 后 ， 你 要 编写 一 个 或 多 个 XML 部 署 说 明 ， 将 对 象 相 关 映 射 细 节 指 定 给 某 个 持久 化 存 
储 空间 ， 说 明 期 望 的 事物 行为 、 安 全 约束 等 。 

业务 逻辑 与 EJB2 应 用 “容器 ”紧密 耦合 。 你 必须 子 类 化 容器 类 型 ， 必 须 提供 许多 个 该 
容器 所 需要 的 生命 周期 方法 。 | 

由 于 存在 这 种 与 重量 级 容器 的 紧 耦 合 ， 隔 离 单 元 测试 就 很 困难 。 有 必要 模拟 出 容器 OX 
很 难 ), 或 者 花费 大 量 时 间 在 真实 服务 器 上 部 署 EJB 和 测试 。 也 由 于 耦合 的 存在 ,在 EJB2 48 
构 之 外 的 复 用 实际 上 变 得 不 可 能 。 

最 终 ， 连 面向 对 象 编程 本 身 也 被 侵蚀 。bean 不 能 继承 自 另 一 个 bean。 留 意 添加 新 账号 的 
逻辑 。 在 EJB2 bean 中 ， 定 义 一 种 本 质 上 是 无 行为 struct 的 “数据 传输 对 象 ”DTO) 很 常见 。 
这 往往 会 导致 拥有 同样 数据 的 元 余 类 型 出 现 , 而 且 也 需要 在 对 象 之 间 复 制 数据 的 八股 式 代 码 。 

横贯 式 关注 面 

在 某 些 领域 ，EBJ2 架构 已 经 很 接近 于 真正 的 关注 面 切 分 。 例 如 ， 在 与 源 代码 分 离 的 部 署 
描述 中 声明 了 期 待 的 事务 、 安 全 及 部 分 持久 化 行为 。 | 

注意 ， 持 久 化 之 类 关注 面 倾向 于 横贯 某 个 领域 的 天 然 对 象 边 界 。 你 会 想 用 同样 的 策略 来 
持久 化 所 有 对 象 ， 例如， 使 用 DBMS! 而 非 平面 文件 ， 表 名 和 列 名 遵循 某 种 命名 约定 ， 采 用 一 
致 的 事务 语义 ， 等 等 。 

原则 上 ， 你 可 以 从 模块 、 封 装 的 角度 推理 持久 化 策略 。 但 在 实践 上 ， 你 却 不 得 不 将 实现 
了 持久 化 策略 的 代码 铺展 到 许多 对 象 中 。 我 们 用 术语 “横贯 式 关注 面 ”来 形容 这 类 情况 。 同 
样 ， 持 久 化 框架 和 领域 逻辑 ， 孤 立地 看 也 可 以 是 模块 化 的 。 问 题 在 于 横贯 这 些 领域 的 情形 。 


Bur: 数据 管理 系统 。 
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实际 上 , EJB 架构 处 理 持久 化 、 安 全 和 事务 的 方法 是 “预期 ”面向 方面 编程 (aspect-oriented 
programming, AOP) !， 而 AOP 是 一 种 恢复 横贯 式 关 注 面 模块 化 的 普 适 手段 。 

在 AOP 中 ， 被 称 为 方面 (aspect) 的 模块 构造 指明 了 系统 中 哪些 点 的 行为 会 以 某 种 一 致 的 
方式 被 修改 ， 从 而 支持 某 种 特定 的 场景 。 这 种 说 明 是 用 某 种 简洁 的 声 明 或 编程 机 制 来 实现 的 。 

以 持久 化 为 例 ， 可 以 声明 哪些 对 象 和 属性 〈 或 其 模式 ) 应 当 被 持久 化 ， 然 后 将 持久 化 任 
务 委托 给 持久 化 框架 。 行 为 的 修改 由 AOP 框架 以 无 损 方式 “在 目 标 代 码 中 进行 。 下 面 来 看 看 
Java 中 的 三 种 方面 或 关 似 方面 的 机 制 。 


11.4 Java 代理 


Java 代理 适用 于 简单 的 情况 ， 例 如 在 单独 的 对 象 或 类 中 包装 方法 调用 。 然 而 ，JDK 提供 
的 动态 代理 仅 能 与 接口 协同 工作 。 对 于 代理 类 ， 你 得 使 用 字 节 码 操作 库 ， 比 如 CGLIB、ASM 
或 Javassist 。 | 

代码 清单 11-3 展示 了 为 我 们 的 Bank 应 用 程序 提供 持久 化 文 持 的 JDK 代理 , RBNA H 
设置 和 取得 账号 列表 的 方法 。 


代码 清单 11-3 JDK 代理 范例 


// Bank.java (suppressing package names...) 
import java.utils.*; 


// The abstraction of a bank. 
public interface Bank { 
Collection<Account> getAccounts(); 
void setAccounts (Collection<Account> accounts); 


} 


// BankImpl.java 
import java.utils.*; 


// The "Plain Old Java Object" (POJO) implementing the abstraction. 
public class BankImpl implements Bank { 
private List<Account> accounts; 


public Collection<Account> getAccounts() { 
return accounts; 


} 


public void setAccounts (Collection<Account> accounts) { 


' 原 注 ， 查 阅 [AOSD] 获 取 有 关 方 面 的 一 般 信息 ， 查 阅 [AspectJ] 和 [Colyer] 获 取 有 关 Aspect] 的 信息 。 
"Rat, 即 无 需 手 工 修改 源 代码 。 
3 原 注 ， 见 [CGLIB]、[ASM] 和 [Javassist] 。 
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this.accounts = new ArrayList«Account»(); 
for (Account account: accounts) { 
this.accounts.add (account); 
) 
) 
} 


// BankProxyHandler.java 
import java.lang.reflect.*; 
import java.util.*; 


// "InvocationHandler" required by the proxy API. 
. public class BankProxyHandler implements InvocationHandler { 


private Bank bank; 


public BankHandler (Bank bank) ( 
this.bank = bank; 
) 


// Method defined in InvocationHandler 
public Object invoke(Object proxy, Method method, Object[] args) 
throws Throwable ( 

String methodName = method.getName(); 

if (methodName.equals ("getAccounts")) { 
bank.setAccounts (getAccountsFromDatabase ()); 
return bank.getAccounts(); 

) else if (methodName.equals("setAccounts")) { 
bank.setAccounts ((Collection<Account>) args[0]); 
setAccountsToDatabase (bank.getAccounts () ) ; 
return null; 

) else ( 


) 


) 

// Lots of details here: 

protected Collection<Account> getAccountsFromDatabase() ( ... ) 

protected void setAccountsToDatabase (Collection<Account> accounts) { ... } 


) i 
// Somewhere else... 


Bank bank = (Bank) Proxy.newProxyInstance( 
Bank.class.getClassLoader(), 
new Class[] ( Bank.class ), 


new BankProxyHandler (new BankImpl())); 
我 们 定义 了 将 被 代理 包装 起 来 的 接口 Bank, 还 有 旧式 的 Java 对 象 (Plain-Old Java Object, 
POJO) BankImpl， 该 对 象 实现 业务 逻辑 〈 稍 后 再 来 看 POJO)。 
Proxy API 需要 一 个 InvocationHandler 对 象 ， 用 来 实现 对 代理 的 全 部 Bank 方法 调用 。 
BankProxyHandler 使 用 Java 反射 API 将 一 般 方法 调用 映射 到 BankImpl 中 的 对 应 方法 ， 以 此 


类 推 。 
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”即便 对 于 这 样 简单 的 例子 ， 也 有 许多 相对 复杂 的 代码 。 使 用 那些 字 节操 作 类 库 也 同样 具 
有 挑战 性 。 代 码 量 和 复杂 度 是 代理 的 两 大 弱点 ， 创 建 整洁 代码 变 得 很 难 ! 另外 ， 代 理 也 没有 
提供 在 系统 范围 内 指定 执行 反 的 机 制 ， 而 那 正 是 真正 的 AOP 解决 方案 所 必 有 A. 


11.5 4h Java AOP 框架 


幸运 的 是 ， 编 程 工具 能 自动 处 理 大 多 数 代 理 模板 代码 。 在 数 个 Java 框架 中 ， 代 理 都 是 内 
WO, 如 Spring AOP 和 JBoss AOP 等 , 从 而 能 够 以 纯 Java 代码 实现 面向 方面 编程 。 在 Spring 
中 ， 你 将 业务 逻辑 编码 为 旧式 Java 对 象 。POJO 自 扫 门 前 雪 ， 并 不 依赖 于 企业 框架 (或 其 他 
域 )。 因 此 ， 它 在 概念 上 更 简单 、 更 易于 测试 驱动 。 相 对 简单 性 也 较 易 于 保证 正确 地 实现 相应 
的 用 户 故事 ， 并 为 未 来 的 用 户 故事 维护 和 改进 代码 。 

， 使 用 描述 性 配置 文件 或 API， 你 把 需要 的 应 用 程序 构架 组 合 起 来 ， 包 括 持 久 化 、 事 务 、 
安 人 全、 缓存、 恢复 等 横贯 性 问题 。 在 许多 情况 下 ， 你 实际 上 只 是 指定 Spring 或 Jboss KE, 
框架 以 对 用 户 透 明 的 方式 处 理 使 用 Java 代理 或 字 节 代码 库 的 机 制 。 这 些 声 明 驱 动 了 依赖 注入 
(DD 容器 ，DI 容器 再 实体 化 主要 对 象 ， 并 按 需 将 对 象 连接 起 来 。 

代码 清单 11-4 展示 了 Spring V2.5 配置 文件 app.xml 的 典型 片段 和 。 


代码 清单 11-4 Spring 2.x 的 配置 文件 


<beans> 


<bean id="appDataSource" 
class="org.apache.commons.dbcp.BasicDataSource" 
destroy-method="close" 
p:driverClassName="com.mysql.jdbc. Driver" 
p:url="jdbc:mysql://localhost:3306/mydb" 
p:username="me"/> 


<bean id="bankDataAccessObject" 
class="com.example.banking.persistence.BankDataAccessObject" 
p:dataSource-ref="appDataSource"/> 


<bean id="bank" 
class-"com.example.banking.model.Bank" 
p:dataAccessObject-ref-"bankDataAccessObject"/» 


` </beans> 


' 原 注 : 要 想 了 解 更 多 关于 Proxy API 及 其 用 法 ， 请 参阅 [Goetz]。 

? AE: AOP 有 时 会 与 实现 它 的 技术 相 混淆 ， 例如 方法 拦截 和 通过 代理 做 的 “ “封包 ”AOP 系统 的 真正 价值 在 于 用 简洁 和 
模块 化 的 方式 指定 系统 行为 。 

> 原 注 ， 见 [Spring] 和 [JBoss].“ 纯 Java” 表 示 不 使 用 AspectJ. 

4 原 注 : 摘自 http://www.theserverside.com/tt/articles/article.tss?l=IntrotoSpring25 
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每 个 bean 就 像 是 髓 套 “ 俄 罗斯 套 娃 ”中 的 一 个 ， 每 个 由 数据 存 取 器 对 象 (DAO) 代理 CE, 
装 ) 的 Bank 都 有 个 域 对 象 ， 而 bean 本 身 又 是 由 JDBC 驱动 程序 数据 源 代理 (如 图 11-3 所 示 )。 







BankDataAcessObject 


图 11-3 “俄罗斯 套 娃 ” 式 的 油漆 工 模式 


客户 代码 以 为 调用 的 是 Bank 对 象 的 getAccount( ) 方 法 ， 其 实 它 是 在 与 一 组 扩展 Bank 
POJO 基础 行为 的 油漆 工 (DECORATOR) ! 对 象 中 最 外 面 的 那个 沟通 。 | 

在 应 用 程序 中 , 只 添加 了 少数 几 行 代码 , 用 来 向 DI 容器 请 求 系统 中 的 顶层 对 象 , 如 XML 
文件 中 所 定义 的 那样 。 


XmlBeanFactory bf = 
new XmlBeanFactory(new ClassPathResource("app.xml", getClass())); 
Bank bank = (Bank) bf.getBean ("bank"); 


RAKE IL Spring 相关 的 Java 代码 ,应 用 程序 几乎 完全 与 Spring 分 离 ， HER T EJB2 
LAG AEA 问题 。 
尽管 XML 可 能 会 兄长 且 难 以 阅读 *， 配 置 文件 中 定义 的 “策略 ” 还 是 要 比 那 种 隐藏 在 幕 
后 自动 创建 的 复杂 的 代理 和 方面 逻辑 来 得 简单 。 这 种 类 型 的 架构 是 如 此 引 人 注 目 ，Spring 之 
类 的 框架 最 终 导致 了 EJB 标准 在 第 3 版 的 彻底 变化 。 使 用 XML 配置 文件 和 /或 Java 5 
annotation, EJB3 很 大 程度 上 遵循 了 Spring 通过 描述 性 手段 支持 横贯 式 关 注 面 的 模型 。 
代码 清单 11-5 展示 了 用 EJB3 HSH Bank WR’. 


代码 清单 11-5”EJB3 版 本 的 Bank 


package com.example.banking.model; 
import javax.persistence.*; 
import java.util.ArrayList; 
import java.util.Collection; 


@Entity 

@Table (name = "BANKS") 

public class Bank implements java.io.Serializable { 
@Id @GeneratedValue (strategy=GenerationType.AUTO) 
private int id; 
@Embeddable // An object "inlined" in Bank's DB row 
public class Address { 

protected String streetAddrl; 


' FRYE: [GOF]. 
” 原 注 ， 可 以 使 用 遵循 “约定 胜 于 配置 ”的 机 制 和 Java 5 annotation 来 减少 外 露 的 连接 逻辑 ， 从 而 简化 这 个 例子 
” 原 注 :摘自 http://www.onjava.com/pub/a/onjava/2006/05/17/standardizing-with-ejb3-java-persistence-api.html。 
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protected String streetAddr2; 
protected String city; ` 
protected String state; 
protected String zipCode; 

) 


@Embedded 
private Address address; 


@OneToMany (cascade = CascadeType.ALL, fetch = FetchType.EAGER, 
mappedBy="bank") 
private Collection<Account> accounts = new ArrayList<Account>(); 


public int getId() { 
return id; 
} 


public void setId(int id) { 
this.id = id; 
} 


public void addAccount (Account account) { 
account.setBank (this) ; 
accounts.add (account) ; 


) 


public Collection<Account> getAccounts() { 
return accounts; 


) 


public void setAccounts(Collection<Account> accounts) { 
this.accounts = accounts; 


) 
) 


上 列 代码 要 比 原 本 的 EJB2 代码 整洁 多 了 。 有 些 实体 细节 仍然 在 annotation 中 存在 。 不 过 ， 因 
为 没有 任何 信息 超出 annotation 之 外 ， 代 码 依然 整洁 、 清 晰 ， 也 因此 而 易于 测试 驱动 、 易 于 维护 。 

如 果 愿 意 的 话 ，annotation 中 有 些 或 全 部 持久 化 信息 可 以 转移 到 XML 部 署 描述 中 ， 只 留 
下 真正 的 纯 POJO。 如 果 持 久 化 映射 细节 不 会 频繁 改动 , 许多 团队 可 能 会 选择 保留 annotation, 
但 与 EJB2 那 种 侵害 性 相 比 还 是 少 了 很 多 问题 。 


11.6 AspectJ 的 方面 


通过 方面 来 实现 关注 面 切 分 的 功能 最 全 的 工具 是 Aspect) 语言 ， 一 种 提供 “一 流 的 ”将 
方面 作为 模块 构造 处 理 支 持 的 Java 扩展 。 在 80%~90% 用 到 方面 特性 的 情况 下 ，Spring AOP 


! 原 注 : 参见 [AspectJ] 和 [Colyer]。 
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和 JBoss AOP 提供 的 纯 Java 实现 手段 足够 使 用 。 然 而 ，Aspect] 却 提供 了 一 套用 以 切 分 关注 
面 的 丰富 而 强 有 力 的 工具 。AspectJ 的 弱势 在 于 ， 需 要 采用 几 种 新 工具 ， 学 习 新 语言 构造 和 使 
用 方式 。 

T8 EH AspectJ 近期 引入 的 “annotation form” (使 用 Java 5 annotation 定义 纯 Java 代码 的 方 
面 )， 新 工具 采用 的 问题 大 大 减少 。 另 外 ，Spring Framework 也 有 一 些 让 拥有 较 少 AspectJ 经 
验 的 团队 更 容易 组 合 基于 annotation 的 方面 的 特性 。 | 

关于 Aspect] 的 全 面 探 讨 已 经 超出 本 书 范围 。 更 多 信息 可 参见 [AspectJ] 、[Colyer] 和 
[Spring]. E 
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通过 方面 式 的 手段 切 分 关注 面 的 威力 不 可 低估 。 假 使 你 能 用 POJO 编写 应 用 程序 的 领域 
逻辑 , 在 代码 层面 与 架构 关注 面 分 离开 , 就 有 可 能 真正 地 用 测试 来 驱动 架构 。 采用 一 些 新 技术 ， 
就 能 将 架构 按 需 从 简单 演化 到 精细 。 没 必要 先 做 大 设计 (Big Design Up Front, BDUF) !. XE 
际 上 ，BDUF 甚至 是 有 害 的 ， 它 阻碍 改进 ， 因 为 心理 上 会 抵制 丢弃 既成 之 事 ， 也 因为 架构 上 
的 方案 选择 影响 到 后 续 的 设计 思路 。 | | 

建筑 设计 师 不 得 不 做 BDUF， 因 为 一 旦 建造 过 程 开 始 ， 就 不 可 能 对 大 型 物理 建筑 的 结构 
做 根本 性 改动 2。 尽 管 软件 也 有 物理 3 的 一 面 ， 只 要 软件 的 构架 有 效 切 分 了 各 个 关注 面 ， 还 是 
有 可 能 做 根本 性 改动 的 。 

这 意味 着 我 们 可 以 从 “简单 自然 ”但 切 分 良好 的 架构 开始 做 软件 项 目 ， 快 速 交 付 可 工作 
的 用 户 故事 ， 随 着 规模 的 增长 添加 更 多 基础 架构 。 有 些 世 界 上 最 大 的 网 站 采用 了 精密 的 数据 
缓存 、 安 全 、 虚 拟 化 等 技术 ， 获 得 了 极 高 的 可 用 性 和 性 能 ， 在 每 个 抽象 层 和 范围 之 内 ， 那 些 
最 小 化 耦合 的 设计 都 简单 到 位 ， 效 率 和 灵活 性 也 随 之 而 来 。 

当然 ， 这 不 是 说 要 毫 无 准备 地 进入 一 个 项 目 。 对 于 总 的 覆盖 范围 、 目 标 、 项 目 进度 和 最 
终 系统 的 总 体 构架 ， 我 们 会 有 所 预期 。 不 过 ， 我 们 必须 有 能 力 随机 应 变 。 

EJB 早期 架构 就 是 一 种 著名 的 过 度 工程 化 而 没 能 有 效 切 分 关注 面 的 API。 在 没 能 真正 得 
到 使 用 时 ， 设 计 得 再 好 的 API 也 等 于 是 杀 鸡 用 牛刀 。 优 秀 的 API 在 大 多 数 时 间 都 该 在 视线 之 
外 ， 这 样 团 队 才能 将 创造 力 集中 在 要 实现 的 用 户 故事 上 。 和 否则， 架构 上 的 约束 就 会 妨碍 向 客 
户 交付 优化 价值 的 软件 。 

概 言 之 ， 

最 佳 的 系 统 架 构 由 模块 化 的 关注 面 领域 组 成 ， 每 个 关注 面 均 用 纯 Java( 或 其 他 语言 


| 原 注 ，BDUF 是 一 种 预先 设计 好 一 切实 现 的 方式 ， 不 能 与 先 做 设计 (up-front design) se eee ERRA 
? 原 注 ， 即 便 在 构建 开始 之 后 ， 也 会 有 大 量 迭 代 式 的 考察 和 细节 讨论 。 
? 原 注 :“ 软 件 物理 ”一 词 最 早 由 [Kolence] 提 出 。 
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对 象 实 现 。 不 同 的 领域 之 间 用 最 不 具有 侵害 性 的 方面 或 类 方面 工具 整合 起 来 。 这 种 架构 
能 测试 驱动 ， 就 像 代码 一 样 。 


11.8 优化 决策 


模块 化 和 关注 面 切 分 成 就 了 分 散 化 管理 和 决策 。 在 巨大 的 系统 中 ， 不 管 是 一 座 城 市 或 一 
个 软件 项 目 ， 无 人 能 做 所 有 决策 。 | 

众所周知 ， 最 好 是 授权 给 最 有 资格 的 人 。 但 我 们 常常 瑟 记 了 ， 延 迟 决策 至 最 后 一 刻 也 
是 好 手段 。 这 不 是 懒惰 或 不 负责 ， 它 让 我 们 能 够 基于 最 有 可 能 的 信息 做 出 选择 。 提 前 决策 
是 一 种 预备 知识 不 足 的 决策 。 如 果 决 策 太 早 ， 就 会 缺少 太 多 客户 反馈 、 关 于 项 目的 思考 和 
实施 经 验 。 

拥有 模块 化 关注 面 的 POJO 系统 提供 的 敏捷 能 力 ， 允 许 我 们 基于 最 新 的 知识 做 出 优 
化 的 、 时 机 刚好 的 决策 。 决 策 的 复杂 性 也 降低 了 。 


11.9 明智 使 用 添加 了 可 论证 价值 的 标准 


建筑 构造 大 有 可 观 ， 既 因为 新 建筑 的 构建 过 程 (即便 是 在 隆冬 季节 )， 也 因为 那些 现今 科 
技 所 能 实现 的 超凡 设计 。 建 筑 业 是 一 个 成 熟 行业 ， 有 着 高 度 优化 的 部 件 、 方 法 和 和 久 经 岁月 历 
练 的 标准 。 
即便 是 轻 量 级 和 更 直截了当 的 设计 已 足 甫 使 用 ， 许 多 团队 还 是 采用 了 EJB2 架构 ， 只 因 
为 EJB2 是 个 标准 。 我 见 过 一 些 团 队 ， 纠 缠 于 这 个 或 那个 名 声 大 品 的 标准 ， 却 丧失 了 对 为 客 
户 实现 价值 的 关注 。 | 
有 了 标准 ， 就 更 易 复 用 想法 和 组 件 、 雇 用 拥有 相关 经 验 的 人 才 、 封 装 好 点 子 ， 以 及 
将 组 件 连接 起 来 。 不过， 创立 标准 的 过 程 有 时 却 漫长 到 行业 等 不 及 的 程度 ， 有 些 标准 没 
能 与 它 要 服务 的 采用 者 的 真实 需求 相 结合 。 


11.10 ”系统 需要 领域 特定 语言 


建筑 ， 与 大 多 数 其 他 领域 一 样 ， 发 展 出 一 套 丰 富 的 语言 ， 有 词汇 、 熟 语 和 清晰 而 简洁 地 
表达 基础 信息 的 句 式 。 在 软件 领域 ， 领 域 特定 语言 (Domain-Specific Language, DSL) “最 


! 原 注 ，[Alexander] 的 著作 对 软件 社区 影响 至 深 。 
* 原 注 : 参见 [DSL]。[JMock] 是 创建 DSL 的 Java API 的 优秀 范例 。 
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MB SRE. DSL 是 一 种 单独 的 小 型 脚本 语言 或 以 标准 语言 写 就 的 API， 领 域 专家 可 以 用 它 
编写 读 起 来 像 是 组 织 严谨 的 散文 一 般 的 代码 。 

优秀 的 DSL 填 平 了 领域 概念 和 实现 领域 概念 的 代码 之 间 的 “壕沟 ”， 就 像 敏 捷 实践 优化 
了 开发 团队 和 甲 方 之 间 的 沟通 一 样 . 如 果 你 用 与 领域 专家 使 用 的 同一 种 语言 来 实现 领域 逻辑 ， 
就 会 降低 不 正确 地 将 领域 翻译 为 实现 的 风险 。 
EES 它 允 许 开发 者 在 恰当 
的 抽象 层级 上 直 指 代码 的 初衷 。 

领域 特定 语言 允许 所 有 抽象 层级 和 应 用 程序 中 的 所 有 领域 ， EERE A i 
使 用 POJO 来 表达 。 


11.11 “小 结 


系统 也 应 该 是 整洁 em, 侵害 性 架构 会 潭 灭 领域 逻辑 ， 剖 击 敏 捷 能 力 。 当 领域 逻辑 受到 轩 
. 扰 ， 质 量 也 就 堪忧 ， 因 为 缺陷 更 易 隐藏 ， 用 户 故 事 更 难 实现 。 当 敏捷 能 力 受到 损害 时 ， 生 产 
力也 会 降低 ，TDD 的 好 处 遗失 殉 尽 。 | 

在 所 有 的 抽象 层级 上 ， 意 图 都 应 该 清晰 可 辨 。 只 有 在 编写 POJO 并 使 用 类 方面 的 机 制 来 
无 损 地 组 合 其 他 关注 面 时 ， 这 种 事情 才 会 发 生 。 

无 论 是 设计 系统 或 单独 的 模块 ， 别 未 了 使 用 大 概 可 工作 的 最 简单 方案 。 
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12.1 通过 先进 设计 达到 整洁 目的 


假使 有 4 条 简单 的 规矩 ， 跟 着 做 就 能 帮助 你 创建 优良 的 设计 ， 会 如 何 ? 假使 遵循 这 些 规 
算 你 就 能 洞 见 代 码 的 结构 和 设计 ， 更 轻易 地 应 用 SRP 和 DIP 之 类 原则 ， 又 会 如 何 ? 
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我 们 中 的 许多 人 认为 ，Kent Beck AF Rt 的 四 条 规则 ， 对 于 创建 具有 良好 设计 的 
软件 有 着 莫大 的 帮助 。 
s F Keth, REHM 以 下 规则 ， 设计 就 能 变 得 “简单 ”: 
运行 所 有 测试 ; 
不 可 重复 ; 
表达 了 程序 员 的 意图 ; 
尽 可 能 减少 类 和 方法 的 数量 ; 
以 上 规则 按 其 重要 程度 排列 。 


122 简单 设计 规则 1， 运 行 所 有 测试 


”设计 必须 制造 出 如 预期 一 般 工 作 的 系统 ， 这 是 首要 因素 。 系 统 也 许 有 一 套 绝 佳 设计 ， 但 
如 果 缺 乏 验证 系统 是 否 真 按 预 期 那样 工作 的 简单 方法 ， 那 就 无 异 于 纸上谈兵 。 

全 面 测 试 并 持续 通过 所 有 测试 的 系统 ， 就 是 可 测试 的 系统 。 看 似 浅显 ， 但 却 重 要 。 不 可 
测试 的 系统 同样 不 可 验证 。 不 可 验证 的 系统 ， 绝 不 应 部 署 。 

幸运 的 是 ， 只 要 系统 可 测试 ， 就 会 导向 保持 类 短小 且 目 的 单一 的 设计 方案 。 遵循 SRP 的 
类 ， 测 斌 起 来 较为 简单 。 测 试 编写 得 越 多 ， 就 越 能 持续 走向 编写 较 易 测试 的 代码 。 所 以 ， 确 
保 系统 完全 可 测试 能 帮助 我 们 创建 更 好 的 设计 。 

紧 耦合 的 代码 难以 编写 测试 。 同 样 编写 测试 越 多 ， 就 越 会 遵循 DIP 之 类 规则 ， 使 用 依 
赖 注入 、 接 口 和 抽象 等 工具 尽 可 能 减少 耦合 。 如 此 一 来 ， 设 计 就 有 长 足 进 步 。 

遵循 有 关 编 写 测试 并 持续 运行 测试 的 简单 、 明 确 的 规则 ， 系统 就 会 更 贴近 OO RAR, 
高 内 聚 度 的 目标 。 编 写 测试 引致 更 好 的 设计 。 


12.3 简单 设计 规则 2 一 4， T 


有 了 测试 ， 就 能 保持 代码 和 类 的 整洁 , 方法 就 是 递增 式 地 重 构 代码 。 添 加 了 几 行 代码 后 ， 
就 要 和 暂停， 琢磨 一 下 变化 了 的 设计 。 设 计 退 步 了 吗 ? 如 果 是 ， 束 要 清理 它 ， 并 且 运 行 测 试 ， 
保证 没有 破坏 任何 东西 。 测 试 消除 了 对 清理 代码 就 会 破坏 代码 的 恐惧 。 

在 重 构 过 程 中 ， 可 以 应 用 有 关 优 秀 软件 设计 的 一 切 知识 。 提 升 内 聚 性 ， 降 低 耦 合 度 ， 切 
分 关注 面 ， 模 块 化 系统 性 关注 面 ， 缩 小 函数 和 类 的 太 寸 ， 选 用 更 好 的 名 称 ， 如 此 等 等 。 这 也 
是 应 用 简单 设计 后 三 条 规则 的 地 方 : 消除 重复 ， 保 证 表达 力 ， 尽 可 能 减少 类 和 方法 的 数量 。 


! 原 注 : [XPE]。 
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424 不 可 重复 


重复 是 拥有 良好 设计 系统 的 大 敌 。 它 代表 着 额外 的 工作 、 额 外 的 风险 和 额外 且 不 必要 的 


复杂 度 。 重 复 有 多 种 表现 。 极 其 雷同 的 代码 行当 然 是 重复 。 类 似 的 代码 往往 可 以 调整 得 更 相 
-_ 似 ， 这 样 就 能 更 容易 地 进行 重 构 。 重 复 也 有 实现 上 的 重复 等 其 他 一 些 形态 。 例 如 ， 在 某 个 群 


: 集 类 中 可 能 会 有 两 个 方法 : 


int size() {} 
boolean isEmpty() {} 


: | 这 两 个 方法 可 以 分 别 实现 。 is Ero Ji BRB 尔 值 ， 而 size 方法 则 跟踪 宗 一 个 计数 
EZ 或 者 ， 也 可 以 通过 在 isEmpty 中 使 用 size 方法 来 消除 重复 : 


boolean isEmpty() ( 
return O -- size(); 


} 
要 想 创建 整洁 的 系统 ， 需 要 有 消除 重复 的 意愿 ， 即便 对 于 短 短 几 行 也 是 如 此 。 例 如 以 下 


ARAB: 


public void scaleToOneDimension( 
float desiredDimension, float imageDimension) { 
if (Math.abs(desiredDimension - imageDimension) « errorThreshold) 


return; 
float scalingFactor = desiredDimension / imageDimension; 
scalingFactor = (float) (Math.floor(scalingFactor * 100) * 0.01f); 


RenderedOp newImage = ImageUtilities.getScaledImage( 
image, scalingFactor, scalingFactor); 
image.dispose(); 
System.gc(); 
image = newImage; 
} 
public synchronized void rotate(int degrees) { 
RenderedOp newImage = ImageUtilities.getRotatedImage ( 
image, degrees); 
image.dispose(); 
System.gc () ; 
image = newImage; 


) 
要 保持 系统 整洁 ， 应 该 消除 scaleToOneDimension 和 rotate 方法 里 面 的 少量 重复 : 


public void pe et 
float desiredDimension, float imageDimension) 1 
if (Math.abs(desiredDimension - imageDimension) < errorThreshold) 
return; . 
float scalingFactor = desiredDimension / imageDimension; 
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scalingFactor = (float) (Math.floor(scalingFactor * 190) * 0.01f); 
replaceImage (ImageUtilities.getScaledImage( 
image, scalingFactor, scalingFactor)); 


) 


public synchronized void rotate(int degrees) ( 
replaceImage (ImageUtilities.getRotatedImage (image, degrees) ) ; 
SE ) | 


private void replacelmage (RenderedOp newImage) { 
|J image.dispose(); 

System.gc() ; 

image = newImage; 


} 


做 了 一 点 所 共性 抽取 后 ， 我 们 意识 到 已 经 违反 了 SRP 原则 。 所 以 ， 可 以 把 一 个 新 方法 分 
解 到 另外 的 类 中 ， 从 而 提升 其 可 见 性 。 团 队 中 的 其 他 成 员 也 许 会 发 现 进一步 抽象 新 方法 的 机 
会 , 并 且 在 其 他 场景 中 复 用 之 。“ 小 规模 复 用 ”可 大 量 降 低 系 统 复杂 性 。 要 想 实现 大 规模 复 用 ， 
必须 理解 如 何 实现 小 规模 复 用 。 

模板 方法 模式 是 一 种 移 除 高 层级 重复 的 通用 技巧 。 例 如 : 


public class VacationPolicy ( 
public void accrueUSDivisionVacation() { 
// code to calculate vacation based on hours worked to date 
vi ae 
// code to ensure vacation meets US minimums 
E erm 
// code to apply vaction to payroll record 
79 eg 
) 
public void accrueEUDivisionVacation() í( 
// code to calculate vacation based on hours worked to date 
du rus 
// code to ensure vacation meets EU minimums 
EL 
// code to apply vaction to payroll record 
II wx 
) 
) 


除了 计算 法 定 最 少数 量 假期 的 部 分 ，accrueUSDivisionVacation 和 NEE 
Vacation 中 有 大 量 代码 雷同 。 那 部 分 的 算法 ， 依 据 员 工 类 型 而 变 。 
可 以 通过 应 用 模板 方法 模式 来 消除 明显 的 重复 。 


abstract public class VacationPolicy ( 
public void accrueVacation() { 
calculateBaseVacationHours (); 
alterForLegalMinimums (); 
applyToPayroll(); 


' 原 注 ，[GOF]。 
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) 


private void calculateBaseVacationHours() ( /* ... */ ); 
abstract protected void alterForLegalMinimums(); 

private void applyToPayroll() ( /* ... */ }; 

} e 


public class USVacationPolicy extends VacationPolicy ( 
@Override protected void alterForLegalMinimums () 
// US specific logic 
} 
) 


public class EUVacationPolicy extends VacationPolicy { 
@Override protected void alterForLegalMinimuns () { 
// EU specific logic 
} | 
} 


子 类 填充 了 accrueVacation 算法 中 的 “空洞 ” 提供 不 重复 的 信息 。 
12.5 FAH 


我 们 中 的 大 多 数 人 都 经 历 过 费解 代码 的 纠缠 。 我 们 中 的 许多 人 自己 就 编写 过 费解 的 代码 。 


” 写 出 自己 能 理解 的 代码 很 容易 ， 因 为 在 写 这 些 代码 时 ， 我 们 正 深入 于 要 解决 的 问题 中 。 代 码 


的 其 他 维护 者 不 会 那么 深入 ， 也 就 不 易 理解 代码 。 

软件 项 目的 主要 成 本 在 于 长 期 维护 。 为 了 在 修改 时 尽量 降低 出 现 缺陷 的 可 能 性 ， 很 有 必 
要 理解 系统 是 做 什么 的 。 当 系统 变 得 越 来 越 复 杂 ， 开 发 者 就 需要 越 来 越 多 的 时 间 来 理解 它 ， 
而 且 也 极 有 可 能 误解 。 所 以 ， 代 码 应 当 清 晰 地 表达 其 作者 的 意图 。 作 者 把 代码 写 得 越 清晰 ， 


其 他 人 花 在 理解 代码 上 的 时 间 也 就 越 少 ， 从 而 减少 缺陷 ， 缩 减 维护 成 本 。 


可 以 通过 选用 好 名 称 来 表达 。 我 们 想 要 听 到 好 类 名 和 好 函数 名 ， 而 且 在 查看 其 权 责 时 不 


”会 大 吃 一 尺 。 


也 可 以 通过 保持 函数 和 类 尺寸 短小 来 表达 。 短 小 的 类 和 函数 通常 易于 命名 ， 易 于 编写 ， 
易于 理解 。 

还 可 以 通过 采用 标准 命 名 法 来 表达 。 例如 ， 设 计 模 式 很 大 程度 上 就 关 平 沟通 和 表达 。 通 
过 在 实现 这 些 模式 的 类 的 名 称 中 采用 标准 模式 名 ,例如 COMMAND 或 VISITOR， 就 能 充分 
地 向 其 他 开发 者 描述 你 的 设计 。 

编写 良好 的 单元 测试 也 具有 表达 性 。 测 试 的 主要 目的 之 一 就 是 通过 实例 起 到 文档 的 作用 。 
读 到 测试 的 人 应 该 能 很 快 理解 某 个 类 是 做 什么 的 。 

不 过 ， 做 到 有 表达 力 的 最 重要 方式 却 是 尝试 。 有 太 多 时 候 ， 我 们 写 出 能 工作 的 代码 ， 就 
转移 到 下 一 个 问题 上 ， 没 有 下 足 功 夫 调 整 代 码 ， 让 后 来 者 易于 阅读 。 记 住 ， 下 一 位 读 代码 的 . 
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人 最 有 可 能 是 你 自己 。 
所 以 ， 多 少 尊重 一 下 你 的 手艺 吧 。 花 一 点 点 时 间 在 每 个 函数 和 类 上 。 选 用 较 好 的 名 称 ， 
将 大 函数 切 分 为 小 函数 ， 时 时 照 拂 自己 创建 的 东西 。 用 心 是 最 珍贵 的 资源 。 


12.6 ” 尽 可 能 少 的 类 和 方法 


即便 是 消除 重复 、 代 码 表达 力 和 SRP 等 最 基础 的 概念 也 会 被 过 度 使 用 。 为 了 保持 类 和 函 。 
数 短小 ， 我 们 可 能 会 造 出 太 多 的 细小 类 和 方法 。 所 以 这 条 规则 也 主张 函数 和 类 的 数量 要 少 。 | 

类 和 方法 的 数量 太 多 ， 有 时 是 由 毫 无 意义 的 教条 主义 导致 的 。 例 如 ， 某 个 编码 标准 就 坚 
—O 称 应 当 为 每 个 类 创建 接口 。 也 有 开发 者 认为 ， 字 段 和 行为 必须 切 分 到 数据 类 和 行为 类 中 。 应 
该 抵制 这 类 教条 ， 采 用 更 实用 的 手段 。 

我 们 的 目标 是 在 保持 函数 和 类 短小 的 同时 ， 保 持 整 个 系统 短小 精怪 。 不 过 要 记 住 ， 这 在 
关于 简单 设计 的 四 条 规则 里 面 是 优先 级 最 低 的 一 条 。 所 以 ， 尽 管 使 类 和 函数 的 数量 尽量 少 是 
很 重要 的 ， 但 更 重要 的 却 是 测试 、 消 除 重复 和 表达 力 。 


12.7 iM 


有 没有 能 替代 经 验 的 一 套 简 单 实 践 手段 昵 ? 当 然 不 会 有 有。 另 一 方面 ， 本 章 中 写 到 的 实践 
来 自 于 本 书 作 者 数 十 年 经 验 的 精练 总 结 。 遵 循 简单 设计 的 实践 手段 ， 开 发 者 不 必 经 年 学 习 就 
能 掌握 好 的 原则 和 模式 。 | | 
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| 编写 整洁 的 并 发 程序 很 难 一 一 非常 难 。 编写 在 单线 程 中 执行 的 代码 简单 得 多 。 编写 表面 上 看 
来 不 错 、 深 入 进去 却 支 离 破碎 的 多 线程 代码 也 简单 。 系 统一 旦 遭受 压力 ， 这 种 代码 就 打 不 住 了 。 
本 章 将 讨论 并 发 编程 的 需求 及 其 困难 之 处 ， 并 给 出 一 些 对 付 这 些 难 点 、 编 写 整洁 的 并 发 
代码 的 建议 。 最 后 ， 我 们 将 讨论 与 测试 并 发 代码 有 关 的 问题 。 | | 
— 整 清 的 并 发 编程 是 个 复杂 话题 ， 值 得 用 一 整 本 书 来 讨论 。 本 书 只 做 概览 ， 并 在 “并 发 纺 
程 IT” 一 章 中 提供 更 详细 的 指引 。 如 果 你 只 是 对 并 发 好 奇 ， 阅 读本 章 就 足够 了 。 如 果 你 需要 
更 深入 地 理解 并 发 ， 就 应 读 完整 个 指引 章 市 。 


13.1 为 什么 要 并 发 


并 发 是 一 种 解 耦 策略 。 它 帮助 我 们 把 做 什么 〈 目 的 ) AAT CATAL) 做 分 解 开 。 在 单线 
程 应 用 中 ， 目 的 与 时 机 紧密 耦合 ， 很 多 时 候 只 要 查看 堆栈 追踪 即 可 断定 应 用 程序 的 状态 。 调 
. 试 这 种 系统 的 程序 员 可 以 设 定 断 点 或 者 断 点 序列 ， 通 过 查看 到 达 哪 个 断 点 来 了 解 系统 状态 。 

解 耦 目的 与 时 机 能 明显 地 改进 应 用 程序 的 吞吐 量 和 结构 。 从 结构 的 角度 来 看 ， 应 用 程序 
看 起 来 更 像 是 许多 台 协 同 工 作 的 计算 机 ， 而 不 是 一 个 大 循环 。 系 统 因 此 会 更 易于 被 理解 ， 给 
出 了 许多 切 分 关注 面 的 有 力 手 段 。 | 

例如 ，Web 应 用 的 Servlet 标准 模式 。 这 类 系统 运行 于 Web Ek EJB 容器 的 保护 锌 之 下 ， 
Web 或 EJB 为 你 部 分 地 处 理 并 发 问题 。 当 有 Web 请 求 时 ，servlet 就 会 异步 执行 。Servlet Së 
序 员 无 需 管 理 所 有 的 请 求 。 原 则 上 ， 每 次 serle 是 在 自己 的 小 世界 中 执行 ， 与 其 他 servlet 
的 执行 是 分 离 的 。 

当然 ， 如 果 只 是 那么 简单 ， 也 就 没 必 要 写 这 一 章 了 。 实 际 上 ，Web 容器 提供 的 解 耦 手段 
离 完 美 还 差 得 远 。Servlet 程序 员 得 非常 警惕 、 非 常 小 心地 保证 并 发 程序 不 出 错 。 同样 ，servlet 
模式 的 结构 性 好 处 还 是 很 明显 。 i | 

但 结构 并 非 采用 并 发 的 唯一 动机 。 有 些 系统 对 响应 时 间 和 吞吐 量 有 要 求 ， 需 要 手工 编写 
并 发 解决 方案 。 例 如 ， 考 虑 一 个 单线 程 信息 聚合 程序 ， 它 从 许多 Web 站 点 获取 信息 ， 再 合并 
写 入 日 志 中 。 因 为 该 系统 是 单线 程 的 ， 它 会 逐个 访问 Web 站 点 ， 在 开始 下 一 个 之 前 等 待 当前 
站 点 访问 完毕 。 每 天 的 执行 时 间 必 须 少 于 24 个 小 时 。 然 而 ， 随 着 要 访问 的 站 点 越 来 越 多 ， 采 
集 所 有 数据 花费 的 时 间 也 越 来 越 多 , 最 终 超过 了 24 个 小 时 的 限制 。 单线 程 程序 许多 时 间 花 在 
等 待 Web 套 接 字 IO 结束 上 面 。 通 过 采用 同时 访问 多 个 站 点 的 多 线程 算法 ， 就 能 改进 性 能 。 

或 者 ， 考 虑 某 个 每 次 花费 1 秒 钟 处 理 一 个 用 户 请 求 的 系统 。 该 系统 在 用 户 量 较 少 的 时 候 
响应 及 时 ， 但 随 着 用 户 数 增加 ， 系 统 的 响应 时 间 也 增加 了 。 没 人 想 排 在 150 个 人 后 面 ! 通过 
并 发 处 理 多 个 用 户 请 求 ， 就 能 改进 系统 响应 时 间 。 

再 或 者 ， 考 虑 某 个 解释 大 量 数据 集 、 但 只 在 处 理 完全 部 数据 后 给 出 一 个 完整 解决 方案 的 系 
统 。 或 许可 以 在 独立 的 计算 机 上 处 理 每 个 数据 集 ， 那 样 的 话 许 多 数据 集 就 能 并 行 地 得 到 处 理 。 
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迷 思 与 误解 


看 来 有 足够 的 理由 采用 并 发 方案 。 然 而 ， 如 前 文 所 述 ， 并 发 编程 很 难 。 如 果 你 不 那么 细 
， 就 会 搞 出 不 堪 入 目的 东西 来 。 看 看 以 下 常见 的 迷 思 和 误解 : 

CD 并 发 总 能 改进 性 能 | | 
E 并 发 有 时 能 改进 性 能 ， 但 只 在 多 个 线程 或 处 理 器 之 间 能 分 享 大 量 等 待 时 间 的 时 候 管 用 。 
L 事情 疫 那么 简单 。 0c | 

E (2) 编写 并 发 程序 无 需 修改 设计 

| ”事实 上 ， 并 发 算法 的 设计 有 可 能 与 单线 程 系统 的 设计 极 不 相同 。 目 的 与 时 机 的 解 耦 往往 
E pA Se ee : 

| OD 在 采用 Web R EB 容器 的 时 候 ， 理 解 并 发 问题 并 不 重要 

实际 上 , 你 最 好 了 解 容器 在 做 什么 ， EE 死 锁 等 问题 。 
下 面 是 一 些 有 关 编 写 并 发 软件 的 中 肯 说 法 : 

© 并 发 会 在 性 能 和 编写 额外 代码 上 增加 一 些 开销 ; 

o e 正确 的 并 发 是 复杂 的 ， 即 便 对 于 简单 的 问题 也 是 如 此 ，; 

_. © 并 发 缺陷 并 非 总 能 重 现 ， 所 以 常 被 看 做 偶发 事件 而 忽略 ， 未 被 当做 真 的 缺陷 看 待 ; 
© 并 发 常常 需要 对 设计 策略 的 根本 性 修改 。 


13.2 Pek 


E 并 发 编程 为 何如 此 之 难 ? 来 看 看 下 面 这 个 小 型 类 : 
public class X { 
private int lastIidUsed; 
public int getNextId() { 
return ++lastIdUsed; 





EN 
Af. 





^^ 比如 ， 创 建 x 的 一 个 实体 ， 将 lastIdUsed 设置 为 42， 在 两 个 线程 中 共享 这 个 实体 。 假 设 
Punta getNextId( ) 方 法 ， 结 果 可 能 有 三 种 输出 : 

。 线程 一 得 到 值 43， 线 程 二 得 到 值 44，lastIdUsed 为 44; 

e ”线程 一 得 到 值 44， 线 程 二 得 到 值 43，lastIdUsed 为 44; 

e 线程 一 得 到 值 43， 线 程 二 得 到 值 43，lastIdUsed 为 42. 
第 三 种 结果 令 人 惊异 *， 当 两 个 线程 相互 影响 时 就 会 出 现 这 种 情况 。 这 是 因为 线程 在 执行 





AUN TE TEUS MESA TU e 
PEPER ENS 3: 和 AIEN SEN HA TE o, 
isa SIE EE EN S E 
Vee te Le PERE a RAT be Y, 
tts ST Ins E RIP UU CEN : : 

1 weis Lan - 


€ STEE ee ERER 
EY Rp EVA TI ue m 


^ FÈ: FEHER, AKTE. (RER: 作者 在 这 里 开 了 个 小 玩笑 。 程 序 员 常 把 不 能 复 现 的 程序 错误 的 原因 归结 为 宇宙 
“射线 等 偶发 性 和 无 法 修正 的 问题 。) 
LO 见 后 文 “ 深 入 挖 握 ” 一 节 。 


EE 
E S 
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| 那 行 Java 代码 时 有 许多 可 能 路 径 可行 ， 有 些 路 径 会 产生 错误 的 结果 。 有 多 少 种 不 rie. o) 


要 真正 回答 这 个 问题 ， 需 要 理解 Just-In-Time 编译 器 如 何 对 PERN, 还 要 理解 Java 


内 存 模 型 认为 什么 东西 具有 原子 性 。 
简 答 一 下 ， 就 生成 的 字 节 码 而 言 ， 对 于 在 getNextId 方法 中 执行 的 那 两 个 线程， 有 28708 


种 不 同 的 可 能 执行 路 径 :。 如 果 lastidUsed 的 类 型 从 int ZH long, 则 可 能 路 径 的 数量 将 增 至 


2704156 种 。 当 然 ， 多 数 路 径 都 得 到 正确 结果 。 问 题 是 其 中 一 些 不 能 得 到 正确 结果 。 


13.3 ”并 发 防御 原则 
下 面 给 出 一 系列 防御 并 发 代码 问题 的 原则 和 技巧 。 


13.3.1 单一 权 责 原则 


单一 权 责 原则 (SRP)“ 认 为 ， 方 法 /类 /组 件 应 当 只 有 一 个 修改 的 理由 。 并 发 设计 自身 足 / 
够 复杂 到 成 为 修改 的 理由 ， 所 以 也 该 从 其 他 代码 中 分 离 出 来 。 不 幸 的 是 ， 并 发 实现 细节 常常 | 


”直接 杠 入 到 其 他 生产 代码 中 。 下 面 是 要 考虑 的 一 些 问题 : 
。 ”并发 相关 代码 有 自己 的 开发 、 修 改 和 调 优生 命 周 期 ; 


。 ”开发 相关 代码 有 自己 要 对 付 的 挑战 ， 和 非 并 发 相关 代码 不 同 ， 而 且 往 往 更 为 困难 ， ， 
。 ”即便 没有 周边 应 用 程序 增加 的 负担 ， 写 得 不 好 的 并 发 代码 可 能 的 出 错 方 式 数量 也 已 


经 足 具 挑 战 性 。 
建议 : 分离 并 发 相关 代码 与 其 他 代码 。 


13.32 推论 : 限制 数据 作用 域 
如 我 们 所 见 ， 两 个 线程 修改 共享 对 象 的 同一 字段 时 ,可 能 互相 干扰 ， 导 致 未 预期 的 行为 。 


解决 方案 之 一 是 采用 synchronized 关键 字 在 代码 中 保护 一 块 使 用 共享 对 象 的 临界 区 《critical 1 


section). Pie Hill Iti dri gie qe a o 就 越 可 能 : 
© 你 会 起 记 保护 
e ALEN IRE SOAR (破坏 了 DRY AWS; 
e 很 难 找到 错误 源 ， 也 很 难 判断 错误 源 。 





' 原 注 ， 见 后 文 “ 路 径 数量 ”一 节 。 

? 原 注 : [PPP]. 

"Rat, 参见 后 文 “客户 端 /服务 器 的 例子 ”一 节 。 
4 AYE: [PRAG]. 
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建议 : UE 严格 限制 对 可 能 被 共享 的 数据 的 访 问 。 


13.3.3 t. 使 用 数据 复 本 


(00 训 免 共享 数据 的 好 方法 之 一 就 是 一 开始 就 避免 共享 数据 。 在 菜 些 情形 下 ， 有 可 能 复制 对 
象 并 以 只 读 方式 对 待 。 在 另外 的 情况 下 , 有 可 能 复制 对 象 ， 从 多 个 线程 收集 所 有 复 本 的 结果 ， 

并 在 单个 线程 中 合并 这 些 结果 。 

”如果 有 各 免 共 享 数 据 的 简易 手段 ， 结 果 代码 就 会 大 大 减少 导致 错误 的 可 能 。 你 可 能 会 关心 
创建 额外 对 象 的 成 本 。 值 得 试验 一 下 看 看 那 是 否 真是 个 问题 。 然 而 ， 假 使 使 用 对 象 复 本 能 避免 

“代码 同步 执行, 则 因 旭 免 了 锁定 而 省 下 的 价 信 有 可 能 补偿 得 上 额外 的 创建 成 本 和 垃圾 收集 开销 
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让 每 个 线程 在 自己 的 世界 中 存在 ， 不 与 其 他 线程 共享 数据 。 每 个 线程 处 理 一 个 客户 端 请 
求 ， 从 不 共享 的 源头 接纳 所 有 请 求 数据 ， 存 储 为 本 地 变量 。 这 样 一 来 ， 每 个 线程 都 像 是 世界 
”中 的 唯一 线程 ， 没 有 同步 需要 。 

例如 ，HttpServlet 的 子 类 接收 所 有 以 参数 形式 传递 给 doGet 和 doPost 方法 的 信息 。 每 个 
Servlet 都 像 拥 有 独立 虚拟 机 一 般 运 行 。 只 要 Servlet 中 的 代码 只 使 用 本 地 变量 ，Servlet 就 不 会 
导致 同步 问题 。 当 然 ， 多 数 使 用 Servlet 的 应 用 程序 最 终 都 还 是 会 用 到 类 似 数 据 库 连 接 之 类 的 

建议 ， 尝试 将 数据 分 解 到 可 被 独立 线程 (可 能 在 不 同 处 理 器 上 ) 操作 的 独立 子 集 。 


13.4 了 解 Java 库 


FAFA, Java 5 提供 了 许多 并 发 开发 方面 的 改进 。 在 用 Java 5 编写 线程 代码 
WT, BERD PLA: 

| e。 使 用 类 库 提 供 的 线程 安全 和 群集; 

e 使 用 executor 框架 (executor framework) HERES: 

e 尽 可 能 使 用 非 锁定 解决 方案 ; 

e 有 几 个 类 并 不 是 线程 安全 的 。 


线程 安全 群集 | 
34 Java 还 年 轻 时 ， Doug Lea 编写 了 Concurrent Programming in Java CD SR (Java 并 
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发 编程 )) 教 程 ', 同时 开发 了 几 个 线程 安全 群集 , 这 些 代码 后 来 成 为 JDK 中 java.util.concurrent 
包 的 一 部 分 。 该 代码 包 中 的 群集 对 于 多 线程 解决 方案 是 安全 的 ， 执 行 良 好 。 实 际 上 ， 在 几 
平 所 有 情况 下 ，ConcurrentHashMap 实现 都 比 HashMap 表现 得 好 。 它 还 支持 同步 并 发 读 
写 ， 也 拥有 支持 非 线程 安全 的 合成 操作 的 方法 。 SEO Java 5， 可 以 采用 


ConcurrentHashMap. 
还 有 几 个 支持 高 级 并 发 设计 的 类 。 以 下 是 其 中 一 小 部 分 ， 如 表 13-1 Bim. 
表 13-1 支持 高 级 并 发 设计 的 类 《〈 部 分 ) 
ReentrantLock 可 在 一 个 方法 中 获取 、 在 另 一 方法 中 释放 的 锁 
Semaphore 经 典 的 “信号 ”的 一 种 实现 ， 有 计数 器 的 锁 
CountDownLatch 在 释放 所 有 等 待 的 线程 之 前 ， 等 待 指定 数量 事件 发 生 的 锁 。 这 样 ， 所 有 线程 都 平等 
地 几乎 同时 启动 


建议 : 检 读 可 用 的 类 。 对 于 Java， 掌 握 java.util.concurrent、java.util.concurrent.atomic 和 
java.util.concurrent.locks. ` 


13.5 了 解 执行 异型 


有 几 种 在 并 发 应 用 中 切 分 行为 的 途径 。 要 讨论 这 些 途 径 ， 我 们 需要 理解 一 些 基础 定义 ， 
如 表 13-2 Bros. 


X 13-2 基础 定义 

限定 资源 并 发 环境 中 有 着 固定 尺寸 或 数量 的 资源 。 例 如 数据 库 连接 和 固定 尺寸 读 / 写 缓存 等 

HAE 每 一 时 刻 仅 有 一 个 线程 能 访问 共享 数据 或 共享 资源 

线程 饥饿 一 个 或 一 组 线程 在 很 长 时 间 内 或 永久 被 禁止 。 例 如 ， 总 是 让 执行 得 快 的 线程 先 运行， 
假如 执行 得 快 的 线程 没完 没 了 ， 则 执行 时 间 长 的 线程 就 会 “ 挨 饿 ” 

EX 两 个 或 多 个 线程 互相 等 待 执行 结束 。 每 个 线程 都 拥有 其 他 线程 需要 的 资源 ， 得 不 到 
其 他 线程 拥有 的 资源 ， 就 无 法 终止 

Et 执行 次 序 一 致 的 线程 ， 每 个 都 想 要 起 步 ， 但 发 现 其 他 线程 已 经 “在 路 上 ”。 由 于 竞 


步 的 原因 ， 线 程 会 持续 尝试 起 步 ， 但 在 很 长 时 间 内 却 无 法 如 愿 ， 甚 至 永远 无 法 启动 
有 了 这 些 定 义 ， 我 们 就 能 讨论 在 并 发 编程 中 用 到 的 几 种 执行 模型 了 。 


' 原 注 : [Lea99]。 
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13.5.1 生产 者 -消费 者 模型 ' 


一 个 或 多 个 生产 者 线程 创建 某 些 工 作 ， 并 置 于 缓存 或 队列 中 ;一 个 或 多 个 消费 者 线程 从 
队列 中 获取 并 完成 这 些 工作 。 生 产 者 和 消费 者 之 间 的 队列 是 一 种 限定 资源 。 


1352 读者 -作者 模型 / 


当 存在 一 个 主要 为 读者 线程 提供 信息 源 ， 但 只 人 
就 会 是 个 问题 。 增 加 吞吐 量 ， 会 导致 线程 饥饿 和 过 时 信息 的 累积 。 更 新 会 影响 吞吐 量 。 协 调 


O 读者 线程， 不 去 读 作者 线程 正在 更 新 的 信息 (反之 亦 然 )， 这 是 一 各 辛苦 的 平衡 工作 。 作 者 线 


程 倾向 于 长 期 锁定 许多 读者 线程 ， 从 而 导致 吞吐 量 问 题 。 
挑战 之 处 在 于 平衡 读者 线程 和 作者 线程 的 需求 ， 实现 正确 操作 ， 提供 合理 的 吞吐 量 ， 避 
免 线程 饥饿 。 


1353 GJBBSAC 


想象 一 下 ， 一 群 哲学 家 环 坐 在 圆桌 旁 。 每 个 哲学 家 的 左手 边 放 了 一 把 叉子 。 桌 面 中 央 
摆 着 一 大 碗 意大利 面 。 哲 学 家 们 思索 良久 ， 直 至 肚子 饿 了 。 每 个 人 都 要 拿 起 又 子 吃饭 。 但 


”除非 手 上 有 两 把 又 子 ， 否 则 就 没 法 进食 。 如 果 远 边 或 右边 的 哲学 家 已 经 取 用 一 把 又 子 ， 中 


间 这 位 就 得 等 到 别人 吃 完 、 放 回 又 子 。 每 位 哲学 家 吃 完 后 ， 就 将 两 把 又 子 放 回 桌面 ， 直 到 


: ATER. 


用 线程 代替 哲学 家 , 用 资源 代替 叉子 , 就 变 成 了 许多 企业 级 应 用 中 进程 竞争 资源 的 情形 。 
如 果 没 有 用 心 设计 ， 这 种 竞争 式 系统 束 会 遭遇 死 锁 、 活 锁 、 吞 吐 量 和 效率 降低 等 问题 。 
你 可 能 遇 到 的 并 发 问题 ,大 多 数 都 是 这 三 个 问题 的 变种 。 请 研究 并 使 用 这 些 算法 ， 这 样 ， 


;过 到 并 发 问题 时 你 就 能 有 解决 问题 的 准备 了 。 


建议 : 学 习 这 些 基础 算法 ， 理 解 其 解决 方案 。 


| 13 6 25 同步 方法 之 间 的 依赖 





170 第 13 章 并 发 编程 


用 来 保护 单个 方法 。 然而 , 如 果 在 同一 共享 类 中 有 多 个 同步 方法 , 系统 就 可 能 写 得 不 太 正 确 了 。 

建议 ， 避 免 使 用 一 个 共享 对 象 的 多 个 方法 。 

有 时 必须 使 用 一 个 共享 对 象 的 多 个 方法 。 在 这 种 情况 发 生 时 ， 有 3 种 写 对 代码 的 手段 : 

。 ”基于 客户 端的 锁定 一 一 客户 端 代码 在 调用 第 一 个 方法 前 锁定 服务 端 ， ere 

覆盖 了 调用 最 后 一 个 方法 的 代码 ; 

。 ”基于 服务 端的 锁定 一 一 在 服务 端 内 创建 锁定 服务 端的 方法 ， 调用 所 有 方法 然后 解 
锁 。 让 客户 端 代码 调用 新 方法 ; 

。 ” 适 配 服 务 端 一 一 创建 执行 锁定 的 中 间 层 。 这 是 一 种 基于 服务 端的 锁定 的 例子 ， 但 不 
Pokar, | 


13.7 保持 同步 区 域 微小 


关键 字 synchronized 制造 了 锁 。 同 一 个 锁 维护 的 所 有 代码 区 域 在 任 一 时 刻 保证 只 有 一 个 线 
程 执行 。 锁 是 昂贵 的 ,因为 它们 带 来 了 延迟 和 额外 开销 。 所 以 我 们 不 愿 将 代码 扔 给 synchronized 
语句 了 事 。 另 一 方面 ， 临 界 区 ?应 该 被 保护 起 来 。 所 以 ， 应 该 尽 可 能 少 地 设计 临界 区 。 

有 些 天 真 的 程序 员 想 通 过 扩大 临界 区 面积 达到 这 个 目的 。 然 而 ， 将 同步 延展 到 最 小 临界 
— —— 降低 执行 效率 ?。 

建议 : 减 小 同步 区 域 。 


13.8 ”很 难 编写 正确 的 关闭 代码 


编写 永远 运行 的 系统 ， 与 编写 运行 一 段 时 间 后 平静 地 关闭 的 系统 是 两 码 事 。 

平静 关闭 很 难 做 到 。 常 见 问 题 与 死 锁 有关， 线程 一 直 等 待 永远 不 会 到 来 的 信号 。 

例如 ， 想 象 一 个 系统 中 有 个 父 线 程 分 裂 出 数 个 子 线程 ， 父 线程 等 待 所 有 子 线程 结束 ， 然 
后 释放 资源 并 关闭 。 如 果 其 中 一 个 子 线程 发 生死 锁 会 怎样 ? 父 线程 将 一 直 等 待 下 去 ， 而 系统 
就 永远 不 能 关闭 。 | 

或 者 ， 考 虑 一 个 被 指示 关闭 的 类 似 系统 。 父 线程 告知 全 体 子 线程 放弃 任务 并 结束 。 如 果 
其 中 两 个 子 线程 正 以 生产 者 /消费 者 模型 操作 会 怎样 呢 ? 假设 生产 者 线程 从 父 线程 处 接收 到 
信号 ， 并 迅速 关闭 。 消 费 者 线程 可 能 还 在 等 待 生 产 者 线程 发 来 消息 ， 于 是 就 被 锁定 在 无 法 接 


' 原 注 ， 参 见 后 文 “方法 之 间 的 依赖 可 能 破坏 同步 代码 ”一 节 。 

2 原 注 : 临界 区 是 为 了 确保 程序 正确 而 要 阻止 同时 使 用 的 代码 区 域 。 
; 原 注 ， 见 后 文 “增加 吞吐 量 ” 一 节 。 

4 原 注 ， 参 见 附录 A“ 死 锁 ” 一 节 。 
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收 到 关闭 信和 号 的 状态 中 。 它 会 死 等 生产 者 线程 ， 水 不 结束 ， 从 而 导致 父 线 程 也 无 法 结束 。 

”这 类 情形 并 非 那么 不 常见 。 如 果 你 要 编写 涉及 平静 关闭 的 并 发 代码 ， 请 多 预 留 一 些 时 间 
搞 对 关闭 过 程 。 

建议 ;尽早 考虑 关闭 问题 ， 尽早 令 其 工作 正常 ， 这 会 花费 比 你 预期 更 多 的 时 间 。 检 视 既 
有 算法 ， 因 为 这 可 能 会 比 想 象 中 难得 多 。 


13.9 测试 线程 代码 


证 明代 码 的 正确 性 不 切实 际 。 测 试 并 不 能 确保 正确 性 。 然 而 ， 好 的 测试 却 能 尽量 降低 风 


” 险 。 这 对 于 所 有 单线 程 解决 方案 都 是 对 的 。 当 有 两 个 或 多 个 线程 使 用 同一 代码 段 和 共享 数据 ， 


事情 就 变 得 非常 复杂 了 。 
建议 ， 编 写 有 潜力 曝露 问题 的 测试 ， 在 不 同 的 编程 配置 、 系 统 配置 和 负载 条 件 下 频繁 运 
行 。 如 果 测 试 失 败 ， 跟 踪 错误 。 别 因为 后 来 测试 通过 了 后 来 的 运行 就 忽略 失败 。 
有 一 大 堆 问题 要 考虑 。 下 面 是 一 些 精练 的 建议 : 
。 ”将 伪 失 败 看 作 可 能 的 线程 问题 
先 使 非 线程 代码 可 工作 
编写 可 插 拔 的 线程 代码 ; 
编写 可 调整 的 线程 代码 ; 
运行 多 于 处 理 器 数量 的 线程 
在 不 同 平台 上 运行 ; 
调整 代码 并 强迫 错误 发 生 。 


p 191 将 伪 失 败 看 作 可 能 的 线程 问题 


线程 代码 寻 致 “不 可 能 失败 的 ”失败 。 多 数 开发 者 缺乏 有 关 线 程 如 何 与 其 他 代码 〈 可 能 


p 由 其 他 作者 编写 ) 互动 的 直觉 。 线 程 代 码 中 的 缺陷 可 能 在 一 千 或 一 百 万 次 执行 中 才 会 显现 一 
次。 重复 执行 想 要 复 现 问题 令 人 诅 丧 。 所 以 开发 者 常常 会 将 失败 归咎 于 宇宙 射线 、 硬 件 错误 
E 或 其 他 “偶发 事件 "。 最 好 假设 这 种 偶发 事件 根本 不 存在 。“ 偶 发 事件 ”被 忽略 得 越久 ， 代 码 
| 就 越 有 可 能 搭建 于 不 完善 的 基础 之 上 。 | 


建议 :不 要 将 系统 错误 归咎 于 偶发 事件 。 


1392 ， 先 使 非 线程 代码 可 工作 


这 看 起 来 太 浅显 ， 但 强调 一 下 不 无 益处 。 确 保 线程 之 外 的 代码 可 工作 。 通 常 ， 这 意味 着 
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创建 由 线程 调用 的 POJO. POJO 与 线程 无 涉 ， 所 以 可 在 线程 环境 之 外 测试 。 能 放 进 POJO 中 
的 代码 越 多 越 好 。 
建议: 不 要 同 时 追踪 非 线程 缺陷 和 线程 缺陷 。 确保 代码 在 线程 之 外 可 工作 。 


1393 ”编写 可 插 拔 的 线程 代码 


编写 可 在 数 个 配置 环境 下 运行 的 线程 代码 ; 

。 单线 程 与 多 个 线程 在 执行 时 不 同 的 情况 ; 

。 线程 代码 与 实物 或 测试 奉 身 互动 ; 

。 用 运行 快速 、 缓 慢 和 有 变动 的 测试 替身 执行 ; 

。 ”将 测试 配置 为 能 运行 一 定数 量 的 迭代 。 

建议 : 编写 可 插 拔 的 线程 代码 ， 这 样 就 能 在 不 同 的 配置 环境 下 运行 


1394 ”编写 可 调整 的 线程 代码 


要 获得 良好 的 线程 平衡 ， 常 常 需要 试 错 。 一 开始 ， 在 不 同 的 配置 环境 下 监测 系统 性 能 。 
要 允许 线程 数量 可 调整 。 在 系统 运行 时 允许 线程 发 生变 动 。 允 许 线程 依据 吞吐 量 和 系统 使 用 
率 自我 调整 。 


1385 运行 多 于 处 理 器 数量 的 线程 


系统 在 切换 任务 时 会 发 生 一 些 事 。 为 了 促使 任务 交换 的 发 生 ， 运 行 多 于 处 理 器 或 处 理 器 
核心 数量 的 线程 。 任 务 交 换 越 频繁 ， 越 有 可 能 找到 错过 临界 区 或 导致 死 锁 的 代码 。 


1396 ”在 不 同 平台 上 运行 


|... 20075£, 我 们 做 了 一 套 关于 并 发 编程 的 课程 该 课程 主要 在 OS X 下 开发 ， 在 运行 于 虚拟 
机 的 Windows XP 上 展示 。 用 于 演示 的 测试 失败 条 件 ， 在 OS X 上 要 比 在 XP 上 失败 得 更 频繁 。 
锌 测试 的 代码 已 知 是 不 正确 的 。 这 正 强 调 了 不 同 操作 系统 有 寿 不 同 线程 策略 的 事实 ， 不 
同 的 线程 策略 影响 了 代码 的 执行 。 在 不 同 环境 中 ， 多 线程 代码 的 行为 也 不 一 样 !。 应 该 在 所 有 
可 能 部 项 的 环境 中 运行 测试 。 
建议 ， 尽早 并 经 常 地 在 所 有 目 慰 平台 上 运行 线程 代码 。 


” 原 注 : 你 是 否 知道 ，Java 的 线程 模型 并 不 保证 线程 抢先 ? 现代 操作 系统 支持 抢先 线程 ， 所 以 你 可 以 “免费 ”获得 这 一 特 
性 。 即 便 如 此 ，JVM 也 没有 做 出 保证 。 
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13.9.7 装置 试 错 代 人 码 


并 发 代码 中 藏 有 缺陷 ， 这 并 不 罕见 。 简 单 的 测试 往往 无 法 曝露 这 些 缺 陷 。 实 际 上 ， 缺 陷 
经 常 隐 藏 于 一 般 处 理 过 程 中 。 可 能 好 几 个 小 时 、 好 几 天 甚至 好 几 个 星期 才 会 跳出 来 一 次 ! 

线程 中 的 缺陷 之 所 以 如 此 不 频繁 、 偶 发 、 难 以 重 现 ， 是 因为 在 几 千 个 穿 过 脆弱 区 域 的 可 
能 路 径 当 中 ， 只 有 少数 路 径 会 真 的 导致 失败 。 经 过 会 导致 失败 的 路 径 的 可 能 性 尺 人 地 低 。 所 
以 ， 侦 测 与 调试 也 非常 之 难 。 

怎么 才能 增加 捕捉 住 如 此 罕见 之 物 的 机 会 ? 可 以 装置 代码 ， 增 加 对 Object.wait( )、 
Object.sleep( )、Object.yield( ) 和 Object.priority( ) 等 方法 的 调用 ， 改 变 代码 执行 顺序 。 

这 些 方法 都 会 影响 执行 顺序 ， 从 而 增加 了 侦 测 到 缺陷 的 可 能 性 。 有 问题 的 代码 ， 最 好 尽 
早 、 尽 可 能 多 地 通 不 过 测试 。 

有 两 种 装置 代码 的 方法 : 

e — DB 

e B3. 


1398 fff 


你 可 以 手工 向 代码 中 插入 wait( ). seent )、 pem FEMUR ROR 
的 代码 时 ， 正 当 如 此 操作 。 
下 面 是 个 例子 : 


public synchronized String nextUrlOrNull() { 
if(hasNext()) { 
String url = urlGenerator.next(); 
Thread.yield(); // inserted for testing. 
updateHasNext () ; 
return url; 


) 


return null; 


} 

插入 对 yield ) 的 调用 ， 将 改变 代码 的 执行 路 径 ， 由 此 而 可 能 导致 代码 在 以 前 未 失败 过 的 
地 方 失败 。 如 果 代码 的 确 出 错 ， 那 并 非 是 因为 你 插入 了 yield( ) 方 法 调用 。 代 码 出 错 了 ， 这 便 
是 失败 的 原因 。 

这 种 手法 有 许多 毛病 : 

e ”你 得 手工 找到 合适 的 地 方 来 插入 方法 调用 ; 


' RUE: 严格 说 来 并 非 如 此 。JVM 不 保证 抢先 线程 ， 故 在 不 抢占 线程 的 系统 上 ， 某 个 特殊 的 算法 可 能 一 直 能 工作 。 反 之 
亦 然 ， 但 会 有 其 他 的 原因 影响 。 
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。 你 怎么 知道 在 哪里 插入 调用 、 揪 入 什么 调用 ? 

e 不 必要 地 在 产品 环境 中 留 下 这 类 代码 ， 将 拖 慢 代码 执行 速度 ， | | 

。 ”这 是 种 无 的 放 矢 的 手段 。 你 可 能 找 不 到 缺陷 。 实 际 上 ， 这 不 在 你 把 握 之 中 。 

我 们 所 需要 的 ， 是 一 种 在 测试 中 但 不 在 生产 中 实现 的 手段 。 RE S LIS 运行 轻易 
地 调整 配置 ， 从 而 增加 总 的 发 现 错误 机 会 。 

无 疑 ， 如 果 将 系统 分 解 为 对 线程 及 控制 线程 的 类 一 无 所 知 的 POJO, 就 能 更 容易 地 找到 
装置 代码 的 位 置 。 而 且 ， 还 能 创建 许多 个 以 不 同方 式 调用 sleep. yield 等 方法 的 POJO 测试 。 


1399 自动 化 


可 以 使 用 Aspect-Oriented Framework、CGLIB 或 ASM 之 类 工具 通过 编程 来 装置 代码 。 
例如 ， 可 以 使 用 有 单个 方法 的 类 : 
public class ThreadJigglePoint { 
public static void jiggle() ( 


) 
ge 


可 以 在 代码 的 不 同位 置 调 用 这 个 方法 : 


public synchronized String nextUrlOrNull() { 

if(hasNext()) { 
ThreadJiglePoint.jiggle(); 
String url = urlGenerator.next(); 
ThreadJiglePoint.jiggle(); 
updateHasNext (); 
ThreadJiglePoint.jiggle(); 
return url; 


} 
return null; 


} 

如 此 ， 你 就 得 到 了 一 个 随机 选择 无 所 作为 、 睡 眠 或 让 步 的 方面 。 

或 者 ， 想 象 ThreadJigglePoint 类 有 两 种 实现 。 第 一 种 实现 jiggle 什么 都 不 做 ， 在 生产 环 
境 中 使 用 。 第 二 种 实现 生成 一 个 随机 数 ， 在 睡眠 、 让 步 或 径直 执行 间 做 选择 。 如 果 上 千 次 地 
做 这 种 随机 测试 ， 大 概 就 能 找到 一 些 缺 陷 的 根源 。 假 如 测试 都 通过 了 ， 至 少 你 可 以 说 自己 已 
谨慎 对 待 。 这 种 方法 看 似 有 点 过 于 简单 ， 但 确 是 替代 复杂 工具 的 一 种 可 选 方案 。 

有 一 种 叫做 ConTest' 的 工具 ， 由 IBM 开发 ， 能 做 类 似 的 事情 ， 但 做 法 却 稍微 复杂 些 。 

要 点 是 让 代码 “异动 ”从 而 使 线程 以 不 同 次 序 执行 。 编写 良好 的 测试 与 “异动 ” 相 组 合 
能 有 效 地 增加 发 现 错误 的 机 会 。 

建议 ， 使 用 异动 策略 搜 出 错误 。 


' RYE: http://www.alphaworks.ibm.com/tech/contest 
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13.10 “小 结 


”并 发 代码 很 难 写 正确 。 加 入 多 线程 和 共享 数据 后 ， 简 单 的 代码 也 会 变 成 辟 梦 。 要 编写 并 
发 代码 ， 就 得 严格 地 编写 整洁 的 代码 ， 否 则 将 面临 微细 和 不 频繁 发 生 的 失败 。 

第 一 要 诀 是 遵循 单一 权 责 原则 。 将 系统 切 分 为 分 离 了 线程 相关 代码 和 线程 无 关 代码 的 
POJO. 确保 在 测试 线程 相关 代码 时 只 是 在 测试 , 没有 做 其 他 事情 。 线 程 相关 代码 应 该 保持 短 
小 和 目的 集中 。 

了 解 并 发 问题 的 可 能 原因 : 对 共享 数据 的 多 线程 操作 ， 或 代用 了 会 共 资 源 池 。 类 似 平静 
关闭 或 停 下 入 环 之 类 边界 NIR, 

学 习 类 库 ， 了 解 基本 算法 。 理 解 类 库 提 供 的 与 基础 算法 类 似 的 解决 问题 的 特性 。 

” 学 习 如 何 找到 必须 锁定 的 代码 区 域 并 锁定 之 。 不 要 锁定 不 必 锁 定 的 代码 。 避 免 从 锁定 区 
域 中 调用 其 他 锁定 区 域 。 这 需要 深刻 理解 某 物 是 否 已 共享 。 尽 可 能 减少 共享 对 象 和 共享 范围 。 
修改 对 象 的 设计 ， 向 客户 代码 提供 共享 数据 ， 而 不 是 迫使 客户 代码 管理 共享 状态 。 

问题 会 跳出 来 。 那 种 在 早期 没 跳 出 来 的 问题 往往 是 偶发 的 。 这 种 所 谓 偶发 问题 ， 通 常 仅 
在 高 负载 下 出 现 或 者 偶然 出 现 。 所 以 ， 你 要 能 在 不 同 平 台 上 、 以 不 同 配置 持续 重复 运行 线程 
代码 。 跟 随 TDD 三 要 则 而 来 的 可 测试 性 意味 着 某 种 程度 的 可 插 拔 性 ， 从 而 提供 了 在 大 量 不 
同 配 置 下 运行 代码 的 必要 支持 。 

如 果 花 扣 时 间 装 置 代码 ， 束 能 极 大 地 提升 发 现 错 误 代 码 的 机 会 。 可 以 手工 做 ， 也 可 以 使 
用 某 种 目 动 化 技术 。 尽 早 这 人 么 做 。 在 将 线程 代码 投入 生产 环境 前 ， 就 要 尽 可 能 多 地 运行 它 。 

只 要 采用 了 整洁 的 做 法 ， 做 对 的 可 能 性 就 有 翻天 履 地 的 提高 。 
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对 一 个 命令 行 参数 解析 程序 的 案例 研究 





(dv. ihe 


本 章 研究 一 个 逐步 改进 的 案例 。 你 将 看 到 一 个 开始 还 不 错 , 规模 扩大 后 即 出 问题 的 模块 。 
你 还 将 看 到 这 个 模块 是 如 何 被 重 构 得 整洁 起 来 的 。 
我 们 中 的 大 多 数 人 都 会 遇 到 解析 命令 行 参数 的 情况 。 如 果 没 有 就 手 的 工具 ， 就 得 遍历 传 
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^ main 函数 的 字符 串 数组 。 有 一 些 不 同 来 源 的 好 工具 ， 但 没有 一 个 是 最 符合 要 求 的 。 所 以 ， 


E 


我 当然 要 自己 写 一 个 。 我 把 它 叫做 Args。 
Args 非常 易于 使 用 。 你 只 要 简单 地 用 输入 参数 和 格式 化 字符 串 构 造 Args 类 ， 再 向 Args 
Exit] 问 参 数值 即 可 。 看 看 下 面 的 简单 例子 


”代码 清单 14-1 Age 的 简单 用 法 
public static void main(String[] args) ( 
try { 
Argsarg = new Args("1,p#,d*", args); 
boolean logging = arg.getBoolean('l!'); 
intport = arg.getInt('p'); 
Stringdirectory = arg.getString('d'); | 
executeApplication(logging, port, directory); 
) catch (ArgsException e) ( 
System.out.printf("Argumenterror:%s\n", e.errorMessage()); 














可 以 看 到 这 有 多 简单 。 我们 只 是 用 两 个 参数 创建 了 Args 类 的 一 个 实体 。 第 一 个 参数 是 格 
式 字符 串 ， 或 范式 字符 串 ， Lp#d*。 它 定义 了 三 个 命令 行 参数 。 第 一 个 ，-1， 是 一 个 布尔 值 参 
数 。 第 二 个 ，-p， 是 一 个 整数 参数 。 第 三 个 ，-d， 是 一 个 字符 串 参 数 。 向 Args 构造 器 传 入 的 
第 二 个 参数 就 是 向 main 传 入 的 命令 行 参 数 数 组 。 

: 如 果 构 造 器 正常 返回 ， 没 有 抛 出 ArgsException 异常 ， 则 命令 行 参数 已 传 入 ，Args 实体 
随时 待命 。 使 用 getBoolean. getInteger 和 getString 等 方法 ， 可 以 用 参数 名 称 获 得 参数 值 。 

不管 是 格式 化 字符 串 或 命令 行 参数 出 现 问题 ， 就 会 抛 出 一 个 ArgsException 异常 。 可 以 从 
该 异常 的 errorMessage 中 获得 关于 错误 的 描述 。 
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“代码 清单 14-2 是 Args 类 的 实现 请 仔细 阅读 。 我 在 代码 风格 和 结构 上 花 了 大 力气 ， 使 
之 值得 仿效 。 


代码 清单 14-2 Args.java 
package com.pbjectmentor.utilities.args; 


import static com.objectmentor.utilities.args.ArgsException.ErrorCode.*; 
import java.util.*; 


public class Args ( 
private Map<Character, ArgumentMarshaler> marshalers; 


private Set<Character> argsFound; 
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private ListIterator<String> currentArgument; 


public Args(String schema, String[] args) throws ArgsException { 
marshalers = new HashMap<Character, ArgumentMarshaler>(); 
argsFound = new HashSet<Character>() ; 


parseSchema (schema) ; 
parseArgumentStrings (Arrays.asList (args) ) ， 


) 


private void parseSchema(String schema) throws ArgsException { 
for (String element : schema.split(",")) 
if (element.length() » 0) 
parseSchemaElement (element.trim()); 
) 
private void parseSchemaElement(String element) throws ArgsException { 
char elementId = element.charAt (0); | 
String elementTail = element.substring(1); 
validateSchemaElementId (elementId); 
if (elementTail.length() == 0) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (elementTail.equals ("*")) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (elementTail.equals("#") ) 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
else if (elementTail.equals ("##") ) 
marshalers.put(elementId, new DoubleArgumentMarshaler()); 
else if (elementTail.equals("[*]")) 
marshalers.put(elementId, new StringArrayArgumentMarshaler()); 
else 
throw new ArgsException(INVALID ARGUMENT FORMAT, elementId, elementTail); 
) 


private void validateSchemaElementId(char elementId) throws ArgsException { 
if (!Character.isLetter(elementId)) 
throw new ArgsException(INVALID ARGUMENT NAME, elementId, null); 
) 


private void parseArgumentStrings (List<String> argsList) throws ArgsException 
( ! 
for (currentArgument = argsList.listIterator(); currentArgument.hasNext () ;) 


{ 


String argString = currentArgument.next (); 


if (argString.startsWith("-")) { 
parseArgumentCharacters (argString.substring(1)); 
) else ( 
currentArgument.previous(); 
break; 


} 
) 
) 


private void parseArgumentCharacters (String argChars) throws ArgsException { 
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for (int i = 0; i < argChars.length(); i++) 
parseArgumentCharacter (argChars.charAt (i)); 


) 


private void parseArgumentCharacter(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get (argChar); i 
if (m == null) { 
throw new ArgsException(UNEXPECTED ARGUMENT, argChar, null); 
) else ( 
argsFound. add (argChar) ; 
try { 
m.set(currentArgument); 
) catch (ArgsException e) ( 
e.setErrorArgumentId (argChar); 
throw e; 
) 
) 
) 


public boolean has(char arg) ( 
return argsFound.contains (arg); 


) 


public int nextArgument() ( » 
return currentArgument.nextIndex(); 


) 


public boolean getBoolean(char arg) { 
return BooleanArgumentMarshaler.getValue (marshalers.get(arg)); 


) 


public String getString(char arg) ( 
return StringArgumentMarshaler.getValue (marshalers.get (arg)); 
) 


public int getInt(char arg) { 
return IntegerArgumentMarshaler.getValue (marshalers.get (arg) ); 
} 


public double getDouble(char arg) { . 
return DoubleArgumentMarshaler. wervaldeuavenaiene: get (arg)); 


) 


public String[] getStringArray(char arg) { 
return StringArrayArgumentMarshaler.getValue (marshalers.get(arg)); 
) 
) 
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注意 ， 你 可 以 从 上 到 下 阅读 这 些 代码 ， 不 用 跳 来 跳 去 ， 也 不 用 先 看 后 面 的 部 分 。 唯 一 需 


要 先 看 的 是 ArgumentMarshaler 的 定义 ， 这 部 分 我 有 意 省 略 了 。 仔 细 看 这 段 代 码 ， 你 应 该 能 
理解 ArgumentMarshaler 接口 是 什么 ， 其 派生 类 做 什么 。 下 面 我 将 向 你 展示 一 部 分 (如 代码 
清单 14-3~14-6 Pras). 
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代码 清单 14-3 ArgumentMarshaler.java 


public interface ArgumentMarshaler { | 
void set(Iterator<String> currentArgument) throws ArgsException; 


) 





代码 清单 14-4 BooleanArgumentMarshaler.java 


public class BooleanArgumentMarshaler implements ArgumentMarshaler { 
private boolean booleanValue = false; 


public void set(Iterator«String» currentArgument) throws ArgsException { 
booleanValue - true; 


} 


public static boolean getValue(ArgumentMarshaler am) { 


if (am != null && am instanceof BooleanArgumentMarshaler) 
return ((BooleanArgumentMarshaler) am) .booleanValue; 
else 


return false; 








代码 清单 14-5 StringArgumentMarshaler.java 


import static com.objectmentor.utilities.args.ArgsException.ErrorCode.*; 


public class StringArgumentMarshaler implements ArgumentMarshaler { 
private String stringValue = ""; 


public void set (Iterator<String> currentArgument) throws ArgsException { 
try ( 
stringValue = currentArgument.next(); 
) catch (NoSuchElementException e) { 
throw new ArgsException (MISSING STRING); 
) 
) 


public static String getValue(ArgumentMarshaler am) ( 


if (am != null && am instanceof StringArgumentMarshaler) : 
return ((StringArgumentMarshaler) am).stringValue; 
else 


return ""; 


代码 清单 14-6 IntegerArgumentMarshaler.java 


import static com.objectmentor.utilities.args.ArgsException.ErrorCode.*; 


public class IntegerArgumentMarshaler implements ArgumentMarshaler { 
private int intValue = 0; 
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public void set(Iterator<String> currentArgument) throws ArgsException ( 
String parameter = null; 
try ( 
parameter = currentArgument.next(); 
intValue = Integer.parseInt(parameter); 
) catch (NoSuchElementException e) { 
throw new ArgsException (MISSING INTEGER); 
} catch (NumberFormatException e) { 
throw new ArgsException(INVALID INTEGER, parameter); 
) 
) 


public static int getValue(ArgumentMarshaler am) ( 


if (am != null && am instanceof IntegerArgumentMarshaler) 
return ((IntegerArgumentMarshaler) am).intValue; 

else 
return 0; 


) 
} 


ArgumentMarshaler 的 其 他 派生 类 以 同样 的 模式 处 理 double 和 String 数组 , 一 一 列 出 反而 

行文 。 你 可 以 练习 自己 实现 它们 。 

还 有 些 信 息 可 能 会 困扰 你 : 错误 码 常 量 的 定义 。 这 些 是 在 ArgsException 类 (代码 清单 
14-7) 中 定义 的 。 


代码 清单 14-7 ArgsException.java 


import static com.objectmentor.utilities.args.ArgsException.ErrorCode.*; 


public class ArgsException extends Exception { 
private char errorArgumentId = '\0'; 
private String errorParameter = null; 
private ErrorCode errorCode = OK; 


public ArgsException() {} 
public ArgsException(String message) { super(message) ; } 


public ArgsException (ErrorCode errorCode) { 
this.errorCode = errorCode; 


) 


public ArgsException(ErrorCode errorCode, String errorParameter) ( 
this.errorCode = errorCode; 
this.errorParameter = errorParameter; 


) 


public 人 errorCode, 
char errorArgumentId, Sring errorParameter) { 
this.errorCode = errorCode; 
this.errorParameter = errorParameter; 
this.errorArgumentId = errorArgumentId; 


DEET EC 
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public char getErrorArgumentId() { 
return errorArgumentId; 


) 


public void setErrorArgumentId(char errorArgumentId) { 
this.errorArgumentId = errorArgumentId; 
) 


public String getErrorParameter() ( 


A. LEE ni SN EE 
E RA ee BEG, 


return errorParameter; 
) x 
public void setErrorParameter(String errorParameter) { A 
this.errorParameter = errorParameter; E 
3 
) 3 
public ErrorCode getErrorCode() ( x 
return errorCode; i 
) 3 
public void setErrorCode(ErrorCode errorCode) { : 
this.errorCode = errorCode; 
) 
public String errorMessage() { 
Switch (errorCode) { 
case OK: e 
return "TILT: Should not get bere, H: i 


case UNEXPECTED ARGUMENT: 
return String.format("Argument -$c unexpected.", errorArgumentId); 
case MISSING STRING: 
return String.format ("Could not find string parameter for -$c.", 3 
errorArgumentId); 
case INVALID INTEGER: 
return String.format("Argument -$c expects an integer but was '$s'.", 
errorArgumentId, errorParameter); 
case MISSING INTEGER: 
return String.format("Could not find integer parameter for -$c.", 
errorArgumentId); 
case INVALID DOUBLE: 
return String.format("Argument -$c expects a double but was '$s'.", 
errorArgumentId, errorParameter); 
case MISSING DOUBLE: 
return String.format ("Could not find double parameter for -$c.", 
errorArgumentIGd); 
case INVALID ARGUMENT NAME: 
return String.format("'$c' is not a valid argument name.", 
errorArgumentId); 


case INVALID ARGUMENT FORMAT: 
return String.format("'$s' is not a valid argument format.", 
errorParameter); 


} 


return ""; 
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) 


public enum ErrorCode ( 

.OK, INVALID ARGUMENT FORMAT, UNEXPECTED ARGUMENT, INVALID ARGUMENT NAME, 
MISSING, STRING, 
MISSING INTEGER, INVALID INTEGER, 
MISSING DOUBLE, INVALID DOUBLE 

) 


为 了 充实 这 么 一 个 简单 概念 的 细节 ， 需 要 如 此 多 代码 ， 这 很 值得 注意 。 原 因 之 一 是 我 们 
使 用 了 Java 这 种 只 四 型 语言 。 作 为 一 种 静态 类 型 语言 ， 需 要 大 量 语句 才能 满足 类 型 系统 的 要 
求 。 在 Ruby. Python 或 Smalltalk 等 语言 中 ， 程 序 会 短 很 多 。 

请 再 次 阅读 这 段 代 码 。 特 别 留意 命名 方式 、 函 数 大 小 和 代码 格式 。 如 果 你 是 经 验 丰 富 的 
程序 员 ， 可 能 会 对 风格 或 结构 有 着 这 样 或 那样 的 不 同 观 点 。 不 过 ， 希 望 你 认为 这 段 程序 总 体 
上 编写 良好 ， 有 着 整洁 的 结构 。 | 

例如 ， 如 何 增加 新 参数 类 型 ， 如 日 期 或 复杂 数字 参数 。 其 实现 手段 很 清楚 ， 而 且 只 需要 
花 一 点 点 力气 即 可 。 简 言 之 , 只 需要 从 ArgumentMarshaler 派生 一 个 新 类 , 写 一 个 新 的 getXXX 
函数 ， 在 parseSchemaElement 函数 中 添加 一 个 新 的 case 语句 。 可 能 还 需要 添加 新 的 
ArgsException.Errorcode 和 新 错误 信息 。 


我 怎么 做 的 ? 


— 先 放松 一 下 神经 。 这 段 程 序 并 非 从 一 开始 就 写成 现在 的 样子 。 更 重要 的 是 ， 我 也 没 指望 
你 能 够 一 次 过 写 出 整洁 、 漂 亮 的 程序 。 如 果 说 我 们 从 过 去 几 十 年 里 面 学 到 什么 东西 的 话 ， 那 
就 是 编程 是 一 种 技艺 其 于 科学 的 东西 。 要 编写 整洁 代码 ,必须 先 写 脐 脏 代码 ， 然 后 再 清理 它 。 

你 应 该 不 会 对 此 感到 惊讶 。 我 们 在 小 学 就 学 过 这 条 真理 了 。 那 时 ， 老 师 (通常 是 徒劳 地 ) 
努力 让 我 们 写作 文 草稿 。 他 们 告诉 我 们 ， 我 们 应 该 先 写 草稿 ， 再 写 二 稿 ， 一 次 又 一 次 地 草 扎 ， 
直至 写 出 终 稿 。 他 们 尽力 告诉 我 们 ， 写 出 好 作文 是 一 个 逐步 改进 的 过 程 。 

多 数 新 手 程序 员 〈 就 像 多 数 小 学 生 一 样 ) 没有 特别 认真 地 遵循 这 个 建议 。 他 们 相信 ， 首 要 
任务 是 写 出 能 工作 的 程序 。 只 要 程序 “能 工作 ”， 就 转移 到 下 一 个 任务 上 ， 而 那个 “能 工作 ”的 
程序 就 留 在 了 最 后 那个 所 谓 “ 能 工作 ”的 状态 。 多 数 老手 程序 员 都 知道 ， 这 是 一 种 自 毁 行为 。 


14.2 Args. 草稿 


代码 清单 14-8 展示 了 Args 类 的 一 个 早期 版 本 。 它 “能 工作 ”但 却 很 烂 。 


' RÈ: 最 近 我 用 Ruby 语言 重 写 了 这 个 模块 。 大 概 只 有 Java 版 本 的 1/7 大 小 ， 而 且 结构 也 稍 好 一 些 。 
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代码 清单 14-8 Argsjava (初稿 ) 


import java.text.ParseException; 
import java.util.*; 


public class Args ( 
private String schema; 
private String[] args; 
private boolean valid = true; 


private Set<Character> unexpectedArguments = new TreeSet<Character>(); 


private Map«Character, Boolean» booleanArgs = 
new HashMap«Character, Boolean>(); 


private Map<Character, String> stringArgs = new HashMap<Character, String>(); 
private Map<Character, Integer» intArgs = new HashMap<Character, Integer>(); 


private Set<Character> argsFound = new HashSet<Character>(); 
private int currentArgument; 

private char errorArgumentId = '\0'; 

private String errorParameter = "TILT"; 

private ErrorCode errorCode = ErrorCode.OK; 


t 


private enum ErrorCode { 


OK, MISSING_STRING, MISSING_INTEGER, INVALID_INTEGER, UNEXPECTED_ARGUMENT 


public Args (String schema, String[] args) throws ParseException { 
this.schema = schema; 
this.args = args; 
valid = parse(); 


} 


private boolean parse() throws ParseException { 
if (schema.length() == 0 && args.length == 0) 
return true; 
parseSchema(); 
try { 
| parseArguments(); 
) catch (ArgsException e) ( 
) 
return valid; 


) 


private boolean parseSchema() throws ParseException { 
for (String element : schema.split(",")) (| 


if (element.length() > 0) { 
String trimmedElement = element.trim(); 
parseSchemaElement (trimmedElement) ; 
} 
} 
return true; 


} 


private void parseSchemaElement (String element) throws ParseException { 


char elementId = element. charht (0); 
String elementTail = element.substring (1); 
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validateSchemaElementId (elementId); 

if (isBooleanSchemaElement (elementTail)) 
parseBooleanSchemaElement (elementId); 

else if (isStringSchemaElement (elementTail)) 
parseStringSchemaElement (elementId); 

else if (isIntegerSchemaElement (elementTail)) { 
parseIntegerSchemaElement (elementId); 

) else ( 
throw new ParseException | 

(String.format("Argument: $c has invalid format: %s.", 
elementId,elementTail),0); 
) 
) 


private void validateSchemaElementId(char elementId) throws ParseException { 
if (!Character.isLetter(elementId)) ( 
throw new ParseException( 
"Bad character:"+elementId+"in Args format: "*schema,0); 
) 
) 


private void parseBooleanSchemaElement(char elementId) { 
booleanArgs.put(elementId, false); 
) 


private void parseIntegerSchemaElement(char elementId) { 
intArgs.put(elementId, 0); 
) 


private void parseStringSchemaElement (char elementId) { 
stringArgs.put(elementId, ""); 
) 


private boolean isStringSchemaElement(String elementTail) ( 
-return elementTail.equals("*"); 


) 


private boolean isBooleanSchemaElement(String elementTail) ( 
return elementTail.length() == 0; | 


) 


private boolean isIntegerSchemaElement(String elementTail) { 
return elementTail.equals("$"); 


) 


private boolean parseArguments() throws ArgsException ( 
for (currentArgument = 0; currentArgument < args.length; currentArgumentt+) { 
String arg = args[currentArgument]; 
parseArgument (arg) ; 
l 
return true; 


} 


private void parseArgument (String arg) throws ArgsException { 
if (arg.startsWith("-")) 
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parseElements (arg); 


} 


private void parseElements (String arg) throws ArgsException { 
for (int i = 1; i < arg.length(); i++) 
parseElement (arg.charAt(i)); 
) 


private void parseElement(char argChar) throws ArgsException { 
if (setArgument (argChar)) 
argsFound.add (argChar); 
else ( 
unexpectedArguments.add (argChar); 
errorCode = ErrorCode.UNEXPECTED ARGUMENT; 
valid = false; | 
) | ' 
} 


private boolean setArgument (char argChar) throws ArgsException { 
if (isBooleanArg (argChar)) 
setBooleanArg(argChar, true); 
else if (isStringArg(argChar) ) 
setStringArg (argChar); 
else if (isIntArg(argChar) ) 
setIntArg (argChar); 
else 
return false; 


return true; 


) 
private boolean isIntArg(char argChar) (return intArgs.containsKey (argChar);) 


private void setIntArg(char argChar) throws ArgsException { 
currentArgumenttt; 
String parameter = null; 
try { | 
parameter = args[currentArgument]; 
intArgs.put(argChar, new Integer (parameter)); 
catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgumentId - argChar; 
errorCode = ErrorCode.MISSING INTEGER; 


— 


throw new ArgsException(); 

catch (NumberFormatException e) { 
valid = false; 

errorArgumentId = argChar; 
errorParameter - parameter; 

errorCode = ErrorCode.INVALID INTEGER; 
throw new ArgsException(); 


— 
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private void setStringArg(char argChar) throws ArgsException { 
currentArgumentt*; 
try ( 
stringArgs.put(argChar, args[currentArgument]); 
) catch (ArrayIndexOutOfBoundsException e) ( 
valid = false; 
errorArgumentId = argChar; 
errorCode = ErrorCode.MISSING STRING; 
throw new ArgsException(); 
) 
) 


private boolean isStringArg(char argChar) ( 
return stringArgs.containsKey (argChar); 


) 


private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.put(argChar, value); 
} 


private boolean isBooleanArg(char argChar) { 
return booleanArgs.containsKey (argChar) ; 


} 


public int cardinality() { 
return argsFound.size(); 


) 


public String usage() ( 
if (schema.length() > 0) 
return "-[" + schema + "]"; 
else 
return ""; 


) 


public String errorMessage() throws Exception { 
switch (errorCode) { 
case OK: ' 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED ARGUMENT: 
return unexpectedArgumentMessage(); 
case MISSING STRING: 
return String.format("Could not find string parameter for -%c.", 


errorArgumentIqd) ; 


case INVALID_INTEGER: 
return String.format ("Argument -%c expects an integer but was '$s'.", 
errorArgumentId, errorParameter) ; 
case MISSING INTEGER: 
return String.format("Could not find integer parameter for -%c.", 
errorArgumentId); 
| 
return ""; 


) 
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private String unexpectedArgumentMessage() { 
StringBuffer message = new StringBuffer("Argument(s) -"); 
for (char c : unexpectedArguments) { 
message.append(c); 


) 


message.append(" unexpected."); 


return message.toString(); 


) 


private boolean falseIfNull(Boolean b) { 
return b != null && b; 
) 


private int zeroIfNull(Integer i) ( 
return i == null? 0 : i; 


) 


private String blankIfNull(String s) ( 
return s == null ? "" ; gs; 


) 


public String getString(char arg) { 
return blankIfNull (stringArgs.get (arg)); 
) 


public int getInt(char arg) { 
return zeroIfNull(intArgs.get(arg)); 
} 


public boolean getBoolean(char arg) | 
return falseIfNull (booleanArgs.get (arg)); 
) 


public boolean has(char arg) { 
return argsFound.contains (arg); 
| 


public boolean isValid() ( 
return valid; 


) 


private class ArgsException extends Exception { 
ny 
希望 你 看 到 这 段 乱七八糟 的 代码 时 ， 第 一 反应 是 “他 没 就 此 罢 手 ， 真 令 人 高 兴 !” 如 果 你 
这 么 想 ， 不 如 想 想 其 他 人 对 你 留置 在 草稿 形态 的 代码 的 想法 吧 。 
实际 上 ,“ 草 稿 ” 大 概 会 是 你 对 这 段 代码 的 最 高 评价 。 它 显然 还 需 打 磨 。 实体 变量 的 数量 
SBP A. un TILT 之 类 奇怪 的 字符 串 ，HashSet 和 TreeSets， 还 有 那些 try-catch-catch 代码 
块 ， 组 成 了 一 个 烂摊子 。 
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”我 不 想 写 出 一 个 烂摊子 。 我 也 一 直 想 保持 一 切 有 序 。 从 函数 和 变量 命名 ， 以 及 程序 的 粗 
略 架 构 中 ， 你 可 以 看 出 这 一 点 。 不 过 ， 显 然 我 没 能 做 到 。 
混乱 是 逐渐 产生 的 。 更 早 的 版 本 并 不 如 此 脐 脏 。 例 如 ， 代 码 清单 14-9 展示 了 一 个 早期 版 
本 代码 ， 那 时 只 支持 Boolean 参数 。 


代码 清单 14-9 Age java (HS Boolean) 


package com.objectmentor.utilities.getopts; 
import java.util.*; 


public class Args { 
private String schema; 
private String[] args; 
private boolean valid; 
private Set<Character> unexpectedArguments = new TreeSet«Character»?(); 
private Map<Character, Boolean» booleanArgs = 
new HashMap<Character, Boolean? (); 
private int numberOfArguments = 0; 


public Args(String schema, String[] args) ( 
this.schema = schema; 
this.args = args; 
valid = parse(); 


) 


public boolean isValid() { 
return valid; 


) 


private boolean parse() { 
if (schema.length() == 0 && args.length -- 0) 
return true; 
parseSchema(); 
parseArguments (); 
return unexpectedArguments.size() == 0; 
) 


private boolean parseSchema() { 
for (String element : schema.split(",")) { 
parseSchemaElement (element); 


) 


return true; 


) 


private void.parseSchemaElement(String element) { 
if (element.length() == 1) ( | 
parseBooleanSchemaElement (element); 
) 
) 
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private void parseBooleanSchemaElement (String element) { 
char c = element.charAt(0); 
if (Character.isLetter(c)) ( 
booleanArgs.put(c, false); 
) 
) 


private boolean parseArguments() { 
for (String arg : args) 
parseArgument (arg); 
return true; 


) 


private void parseArgument (String arg) ( 
if (arg.startsWith("-")) 
parseElements (arg); i 


} 


private void parseElements (String arg) { 
for (int i = 1; i < arg.length(); i++) 
parseElement (arg.charAt (i)); 








8 
private void parseElement(char argChar) { KE 
if (isBoolean(argChar)) { E 
numberOfArguments-**t; E 
setBooleanArg(argChar, true); E 

) else iac. 


unexpectedArguments.add(argChar) ; 


) 


private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.put(argChar, value); 
) 


private boolean isBoolean(char argChar) { 
return booleanArgs.containsKey (argChar); 


) 


public int cardinality() ( 
return numberOfArguments; 
) 


public String usage() { 
if (schema.length() » 0) 
return "-[" + schema + "]"; 
else 
return ""; 


) 


public String errorMessage() { 
if (unexpectedArguments.size() > 0) ( 
return unexpectedArgumentMessage(); 
) else 
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return ""; 


) 


private String unexpectedArgumentMessage() { 
StringBuffer message = new StringBuffer("Argument(s) -"); 
for (char c : unexpectedArguments) { 
message.append(c); 
) 


message.append(" unexpected."); 


return message.toString(); 


) 


public boolean getBoolean(char arg) { 
return booleanArgs.get (arg); 
) 
) 


191 


尽管 你 可 能 对 这 段 代 码 很 不 满意 ， 其 实 它 并 非 如 此 之 烂 。 它 精练 、 简 单 ， 易 于 理解 。 然 
而 ， 在 这 段 代码 中 很 容易 找到 后 面 烂摊子 的 根源 。 很 清楚 能 看 到 小 问题 如 何 变 成 大 混乱 的 。 
注意 ， 后 来 的 混乱 代码 只 比 这 个 版 本 多 支持 两 种 参数 类 型 ，String 和 integer。 只 增加 两 
种 参数 类 型 支持 ， 就 对 代码 产生 了 如 此 巨大 的 负面 影响 。 它 从 某 种 可 维护 之 物 变 成 了 满 是 缺 


陷 的 东西 。 


我 逐步 添加 了 对 这 两 种 参数 类 型 的 支持 。 首 先 ， 我 添加 对 String 参数 的 支持 ， 就 像 这 样 ， 


代码 清单 14-10 Args.java (Boolean 和 String) 


package com.objectmentor.utilities.getopts; 


import java.text.ParseException; 
import java.util.*; 


public class Args { 
private String schema; 
private String[] args; 
private boolean valid = true; 
private Set<Character> unexpectedArguments = new TreeSet<Character>(); 
private Map<Character, Boolean> booleanArgs = 
new HashMap<Character, Boolean>(); 


private Map<Character, String> stringArgs = 
new HashMap<Character, String>(); 
private Set<Character> argsFound = new HashSet<Character>(); 
private int currentArgument; 
private char errorArgument = '\0'; 


enum ErrorCode { 
OK, MISSING_STRING} 


private ErrorCode errorCode = ErrorCode.OK; 
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public Args(String schema, String[] args) throws ParseException { 
this.schema = schema; | 
this.args = args; 
valid = parse(); 


) 


private boolean parse() throws ParseException { 
if (schema.length() == 0 && args.length -- 0) 
return true; 
parseSchema(); 
parseArguments () ; 
return valid; 


} 


private boolean parseSchema() throws ParseException { 
for (String element : schema.split(",")) { 
if (element.length() > 0) { 
String trimmedElement = element.trim(); 
parseSchemaElement (trimmedElement) ; 
) 
) 
return true; 


) 


private void parseSchemaElement(String element) throws ParseException { 
char elementId = element.charAt(0); 
String elementTail - element.substring(1); 
validateSchemaElementId (elementId); 
if (isBooleanSchemaElement (elementTail)) 
parseBooleanSchemaElement (elementId); 
else if (isStringSchemaElement (elementTail)) 
parseStringSchemaElement (elementId); 


) 


private void validateSchemaElementId(char elementId) throws ParseException { 
if (!Character.isLetter(elementId)) { 
throw new ParseException( 
"Bad character:" + elementId + "in Args format: " + schema, 0); 


) 


private void parseStringSchemaElement(char elementId) ( 
stringArgs.put(elementId, ""); 
) 


private boolean isStringSchemaElement (String elementTail) { 
return elementTail.equals("*"); 


) 


private boolean isBooleanSchemaElement (String elementTail) { 
return elementTail.length() == 0; 


) 
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private void parseBooleanSchemaElement (char elementId) { 
booleanArgs.put(elementId, false); 
) 


private boolean parseArguments() { 
for (currentArgument = 0; currentArgument < args.length; currentArgument-**) 
{ 
String arg = args[currentArgument]; 
parseArgument (arg) ; 
) 
return true; 


) 


private void parseArgument(String arg) { 
if (arg.startsWith("-")) 
parseElements (arg); 
) 


private void parseElements(String arg) | 
for (int i » 1; i « arg.length(); i++) 
parseElement (arg.charAt(i)); 


) 


private void parseElement(char argChar) | 
if (setArgument (argChar)) 
argsFound.add (argChar); 
else { 
unexpectedArguments.add(argChar) ; 
valid = false; 
} 
} 


private boolean setArgument (char argChar) { 

boolean set = true; 

if (isBoolean (argChar) ) 
setBooleanArg(argChar, true); 

else if (isString(argChar) ) 
setStringArg(argChar, ""); 

else 
set = false; 


return set; 


} 


private void setStringArg(char argChar, String s) { 
currentArgument+t; 
try { | 


stringArgs.put(argChar, args[currentArgument]); 
) catch (ArrayIndexOutOfBoundsException e) ( 
valid = false; 
errorArgument - argChar; 
errorCode = ErrorCode.MISSING, STRING; 
) 
) 
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private boolean isString (char argChar) { 
return stringArgs.containsKey (argChar) ; 


} 


private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.put (argChar, value); 
) 


private boolean isBoolean(char argChar) { 
return booleanArgs.containsKey (argChar) ; 


) 


public int cardinality() { 
return argsFound.size(); 


) 


public String usage() { 
if (schema.length() > 0) | 
return "-[" + Schema + "]"; 
else 
return ""; 


} 


public String errorMessage() throws Exception { 
if (unexpectedArguments.size() > 0) { 
return unexpectedArgumentMessage () ; 
} else 
switch (errorCode) { 
case MISSING STRING: 
return String.format("Could not find string parameter 
errorArgument) ; 
cage OK: 
throw new Exception("TILT: Should not get here."); 
} 
return ""; 


} 


private String unexpectedArgumentMessage() { 
StringBuffer message = new StringBuffer ("Argument (s) -"); 
for (char c : unexpectedArguments) { 
message.append (c); 
} 


message.append(" unexpected. "Ti: 


return message.toString()] 


) 


public boolean getBoolean(char arg) { 
return falseIfNull (booleanArgs.get (arg) ); 
} 


private boolean falseIfNull(Boolean b) { 
return b == null ? false : b; 


) 


for 


zu: o PAR 


Atout, di 
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public String getString(char arg) ( 
return blankIfNull(stringArgs.get(arg)); 
) 


private String blankIfNull(String s) { 
return s == null ? "" : s; 


) 


public boolean has(char arg) { 
return argsFound.contains (arg); 


) 


public boolean isValid() ( 
return valid; 
) 
) 


你 可 以 看 到 ， 代 码 开始 失去 控制 。 还 算 不 上 可 怕 ， 但 混乱 已 经 开始 生长 。 已 经 出 现 了 一 
堆 东西 ， 不 过 还 没 烂 掉 。 增 加 对 整数 参数 类 型 的 支持 后 ， 那 堆 东 西 就 真 的 变质 腐烂 了 


142.1 所 以 我 暂停 了 


还 有 至 少 两 种 参数 类 型 要 添加 ， 而 且 情形 一 定 会 更 加 糟糕 。 如 果 一 味 蛮 干 ， 大 概 也 能 让 它 工 
TE, 不 过 就 会 留 下 一 大 堆 要 调整 的 混乱 。 如果 希 望 代码 结构 一 直 可 维护 , 现在 就 是 调整 的 时 机 了 。 

所 以 我 暂停 添加 特性 ， 开 始 重 构 。 由 于 刚 添加 了 String 和 integer 参数 ， 我 知道 每 种 参数 类 
型 都 需要 在 三 个 主要 位 置 增加 新 代码 。 首 先 ,每 种 参数 类 型 都 要 有 解析 其 范式 元 素 、 从 而 为 该 种 
类 型 选择 HashMap 的 方法 。 其 次 ， 每 种 参数 类 型 都 需要 在 命令 行 字符 串 中 解析 ， 然 后 再 转换 为 
真实 类 型 。 最 后 , 每 种 参数 类 型 都 需要 一 个 getXXX 方法 , 按照 其 真实 类 型 向 调用 者 返回 参数 值 。 

许多 种 不 同类 型 ， 类 似 的 方法 一 一 听 起 来 像 是 个 类 。ArgumentMarshaler 的 概念 就 是 这 
样 产生 的 。 


1422 渐进 


毁坏 程序 的 最 好 方法 之 一 就 是 以 改进 之 名 大 动 其 结构 有些 程序 永远 不 能 从 这 种 所 谓 “ 改 
进 ” 中 恢复 过 来 。 问 题 在 于 ， 很 难 让 程序 以 “改进 ”之 前 的 方式 工作 。 

为 了 避免 这 种 状况 发 生 ， 我 采用 了 测试 驱动 开发 的 规程 。 这 种 手法 的 核心 原则 之 一 是 保 
持 系 统 始终 能 运行 。 换 言 之 ,， 采用 TDD， 我 不 会 允许 做 出 破坏 系统 的 修改 。 每 次 修改 都 必须 
保证 系统 能 像 以 前 一 样 工作 。 | | 

我 需要 一 套 能 随 需 运行 、 确 保 系 统 行为 不 会 改动 的 自动 化 测试 。 在 我 搞 出 那个 烂摊子 的 
同时 , 也 为 Args 类 创建 了 一 套 单元 测试 和 验收 测试 。 单 元 测试 用 Java 写成 , 采用 JUnit 管理 。 
验收 测试 用 FitNesse 以 wiki 页 形式 写成 。 我 可 以 随时 运行 这 些 测试 ， 如 果 测 试 通过 ， 就 能 打 
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票 说 系统 以 我 期 望 的 方式 工作 。 
于 是 我 开始 做 出 大 量 小 规模 修改 。 每 次 修改 都 将 系统 结构 向 A 概念 的 
方向 推动 。 而 且 每 次 修改 后 ， 系 统 都 要 能 工作 。 第 一 个 修改 是 在 烂摊子 末尾 添加 
ArgumentMarshaler 的 轮廓 。 


BEE 
Sos each uh Et EL OL 


代码 清单 14-11 D Args.java 添加 ArgumentMarshaler 
private class ArgumentMarshaler { 
private boolean booleanValue = false; 


public void setBoolean(boolean value) { 
booleanValue = value; 


} 


public boolean getBoolean() (return booleanValue; } 


} 


private class BooleanArgumentMarshaler extends ArgumentMarshaler { 


) 


private class StringArgumentMarshaler extends ArgumentMarshaler { 


) 


private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
) 
) 


显然 ， 这 什么 也 不 会 破坏 。 于 是 我 做 了 一 点 最 简单 的 、 破 坏 性 尽 可 能 小 的 修改 。 我 修改 
了 HashMap， 采 用 ArgumentMarshaler， 使 之 支持 Boolean BAX. 


private Map«Character, ArgumentMarshaler> booleanArgs = 
new HashMap<Character, ArgumentMarshaler> () ; 


这 个 修改 影响 到 少数 语句 ， 我 很 快 就 修正 了 。 


private void parseBooleanSchemaElement(char elementId) | 
booleanArgs.put(elementId, new BooleanArgumentMarshaler()); 
) 


private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.get(argChar).setBoolean (value); 
) 


public boolean getBoolean(char arg) { 
return falseIfNull (booleanArgs.get (arg).getBoolean()); 
) 


注意 ， 这 些 修改 正 是 在 我 之 前 提 到 的 那些 区 域 之 内 所 做 的 ; 参数 类 型 的 parse、set 和 get 
操作 。 不 幸 的 是 ， 即 便 修 改 如 此 细微 ， 有 些 测 试 还 是 会 失败 。 仔 细 看 getBoolean， 可 以 看 到 
如 果 用 y 去 调用 、 而 并 没有 y 这 个 参数 ， 则 booleanArgs.get('y') 就 会 返回 null 值 ， 函 数 将 抛 出 
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一 个 NullPointerException 异常 。 函 数 falseIfNull 用 以 防止 这 种 状况 发 生 ， 但 我 做 出 的 修改 却 
导致 该 函数 无 所 作为 。 | | 

渐进 主义 要 求 我 在 做 其 他 修改 之 前 迅速 修正 这 个 问题 。 修 正 并 不 费劲 。 我 只 是 把 对 null 
值 的 检查 移 了 个 位 置 。 再 也 不 用 检测 bollean 是 否 为 null， 而 是 检查 ArgumentMarshaler 是 否 
为 null。 

首先 ， 我 移 除 了 getBoolean 函数 中 的 falseIfNull 调用 。 现 在 它 没什么 用 了 ， 所 以 我 也 删 
去 了 这 个 函数 。 测 试 还 是 以 同样 的 方式 失败 ， 所 以 我 确定 没有 引入 新 的 错误 。 | 

public boolean getBoolean(char arg) { 


return booleanArgs.get (arg). getBoolean(); 
) 


下 一 步 ,我 把 函数 拆 解 为 两 行 , 并 把 ArgumentMarshaler 放 到 它 自 己 的 名 为 argumentMarshaler 
的 变量 中 。 我 不 在 意 变 量 名 太 长 ， 但 它 却 有 点 喝 睦 ， 把 函数 搞 得 支离破碎 。 所 以 我 把 变量 名 缩 
短 为 am[N5]。- 


public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = booleanArgs.get (arg); 
return am.getBoolean(); | 


) 
然后 再 放 入 检测 null 值 的 逻辑 。 


public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = booleanArgs.get (arg); 
return am != null && am.getBoolean(); 


) 
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添加 String 参数 和 添加 boolean 参数 非常 像 。 我 要 修改 HashMap, ik parse. set 和 get GI 
数 能 工作 。 跟 着 就 是 按部就班 ， 但 我 似乎 该 把 所 有 的 marshalling 〈 编 组 ) 实现 放 到 
ArgumentMarshaler 基 类 而 不 是 派生 类 中 。 


private Map<Character, ArgumentMarshaler> stringArgs = 
new HashMap<Character, ArgumentMarshaler>() ; 


private void parseStringSchemaElement(char elementId) { 
stringArgs.put(elementId, new StringArgumentMarshaler ()) ; 
} ` 


private void setStringArg(char argChar) throws ArgsException { 


' 译注 ， 即 创建 一 个 类 型 为 ArgumentMarshaler 的 对 象 实体 。 
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currentArgument++; 
try { 
stringArgs.get(argChar).setString(args[currentArgument]); 
) catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgumentId = argChar; 
errorCode = ErrorCode.MISSING, STRING; 
throw new ArgsException(); 
) 
) 


public String getString(char arg) { 
Args.ArgumentMarshaler am - stringArgs.get (arg); 
return am == null ? "" 5: am.getString(); 


) 


private class ArgumentMarshaler { 
|J private boolean booleanValue = false; 
private String stringValue; 


public void setBoolean(boolean value) { 
booleanValue = value; 


} 


public boolean getBoolean() { 
return booleanValue; 


} 


public void setString(String s) { 
stringValue = s; 


} 


public String getString() { 
return stringValue == null ? "" : stringValue; 
" 

] 


- 同样 , 也 是 每 次 修改 一 个 地 方 ,持续 运行 测试 。 如 果 测 试 出 错 , 在 做 下 一 个 修改 前 确保 通过 。 
现在 你 应 该 明白 我 的 意图 了 。 一旦 我 将 当前 的 编组 行为 放 到 ArgumentMarshaler 基 类 中 ， 
就 会 开始 往 派生 类 推 入 该 行为 。 这 样 ， 在 我 逐渐 修改 程序 的 形状 时 ， 还 能 保持 一 切 正常 。 
下 一 步 显 而 易 见 ， 把 int 参数 的 相关 功能 放 到 ArgumentMarshaler 里 面 。 同 样 ， 也 是 照 方 抓 药 。 


private Map<Character, ArgumentMarshaler> intArgs = 
new HashMap<Character, ArgumentMarshaler>() ; 


private void parseIntegerSchemaElement (char elementId) { 
intArgs.put(elementId, new IntegerArgumentMarshaler ()) ; 
} 


private void setIntArg(char argChar) throws ArgsException { 
currentArgument+t+; 

String parameter = null; 

try { 
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parameter = args[currentArgument]; 

intArgs.get(argChar) .setInteger (Integer. parseInt (parameter) ) ; 
} catch (ArrayIndexOutOfBoundsException e) { 

valid = false; 

errorArgumentId = argChar; 

errorCode = ErrorCode.MISSING INTEGER; 

throw new ArgsException(); 

} catch (NumberFormatException e) { 


valid = false; 
errorArgumentId = argChar; 
errorParameter = parameter; 


errorCode = ErrorCode.INVALID INTEGER; 
throw new ArgsException(); 
) 


public int getInt(char arg) { 
Args.ArgumentMarshaler am = intArgs.get(arg); 
return am == null ? 0 : am.getInteger(); 

) 


private class ArgumentMarshaler { 
private boolean booleanValue = false; 
private String stringValue; 

private int integerValue; 


public void setBoolean(boolean value) { 
booleanValue = value; 


} 


public boolean getBoolean() { 
return booleanValue; 


) 


public void setString(String s) { 
stringValue = s; 
| 
public String getString() { | 
return stringValue -- null ? "" ; stringValue; 


public void setInteger(int i) { 
integerValue = i; 


public int getInteger() | 
return integerValue; 


} 
} 


当 所 有 的 编组 操作 都 放 到 了 ArgumentMarshaler 中 ， 我 开始 向 派生 类 移植 功能 。 第 一 步 


是 把 setBoolean 函数 放 到 BEER 中 ， 确 保 它 能 正确 调用 。 所 以 我 创建 了 
一 个 抽象 的 set 方法 。 


200 第 14 章 逐步 改进 


private abstract class ArgumentMarshaler { 
protected boolean booleanValue = false; 
private String stringValue; 

private int integerValue; 


public void setBoolean(boolean value) { 
booleanValue = value; 


) 


public boolean getBoolean() { 
return booleanValue; 


} 


public void setString(String s) { 
stringValue = s; . , 


) 


public String getString() { 
return stringValue -- null ? "" : stringValue; 


} 


public void setInteger(int i) { 
integerValue = i; 


} 


public int getInteger() { 
return integerValue; 


} 


public abstract void set(String s); 
} 


然后 在 BooleanArgumentMarshaler 中 实现 set 方法 。 


private class BooleanArgumentMarshaler extends ArgumentMarshaler { 
public void set(String s) ( 
booleanValue = true; 
} 
} 


最 后 ， 通 过 调用 set, SEN setBoolean 的 调用 。 


private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.get (argChar).set("true"); 
) 


测试 仍然 全 部 通过 。 因 为 这 次 修改 导致 set 函数 放 到 了 BooleanArgumentMarshaler 里 面 ， 
我 就 从 ArgumentMarshaler 基 类 删除 了 setBoolean 方法 。 

注意 , 抽象 函数 set 有 一 个 String 参数 , 但 其 在 BooleanArgumentMarshaler 中 的 实现 却 没 
有 使 用 这 个 参数 。 之 所 以 在 这 里 放 个 参数 ， 是 因为 我 知道 StringArgumentMarshaler 和 
IntegerArgumentMarshaler 可 能 会 使 用 它 。 | 

跟着 ， 我 打算 把 get 方法 放 到 BooleanArgumentMarshaler 中 。 这 有 点 难看 ， 因 为 返回 类 
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型 必须 是 Object， 且 在 这 里 需要 转换 为 Boolean 值 。 


public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = booleanArgs.get (arg); 
return am != null && (Boolean)am.get(); 


) 
为 了 编译 通过 ， 我 把 get 函数 加 到 ArgumentMarshaler 中 。 


private abstract class ArgumentMarshaler { 


public Object get() | 
return null; 


) 
) 


这 样 一 来 ， 虽 然 可 以 编译 ， 但 却 无 法 通过 测试 。 只 要 将 get 修改 为 抽象 方法 ， 并 在 
BooleanArgumentMarshaler 中 实现 ， 就 能 重新 通过 测试 。 


private abstract class ArgumentMarshaler { 


protected boolean booleanValue = false; 


public abstract Object get(); 
) 


private class BooleanArgumentMarshaler extends ArgumentMarshaler 
public void set(String s) { 

booleanValue = true; 
) 


{ 


public Object get() { 
return booleanValue; 


} 
} 


测试 又 通过 了 。'get 和 set 方法 都 已 部 署 到 BooleanArgumentMarshaler 中 ! 这 样 我 就 可 以 
从 ArgumentMarshaler 里 面 移 除 旧 的 getBoolean 函数 ， 把 受 保护 的 booleanValue 变量 向 下 移 


动 到 BooleanArgumentMarshaler， 并 将 其 设置 为 private。 
对 于 String 也 照 此 办 理 。 我 修改 了 set 和 get 的 部 署 方式 , 删除 无 用 的 函数 , 并 移动 了 变量 。 


private void setStringArg(char argChar) throws ArgsException { 
currentArgument-t*; 

try { 

stringArgs.get (argChar).set(args[currentArgument]); 

} catch (ArrayIndexOutOfBoundsException e) { 

valid = false; 

errorArgumentId = argChar; 

errorCode = ErrorCode.MISSING STRING;. 

throw new ArgsException(); 


) 
) 
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public String getString(char arg) { 
Args.ArgumentMarshaler am = stringArgs.get(arg); 
return am == null ? "" ; (String) am.get(); 


) 


private abstract class ArgumentMarshaler { 
private int integerValue; 


public void setInteger(int i) { 
integerValue = i; 


} 


public int getInteger() { 
return integerValue; 


) 


public abstract void set(String s); 


public abstract Object get(); 
) 


private class BooleanArgumentMarshaler extends ArgumentMarshaler { 
private boolean booleanValue = false; 


public void set(String s) { 
booleanValue = true; 


) 


public Object get() { 
return booleanValue; 


) 
) 


private class StringArgumentMarshaler extends ArgumentMarshaler { 


private String stringValue = ""; 


public void set(String s) { 
stringValue = 8; 
| 


public Object get() { 
return stringValue; 


} 
) 


private class IntegerArgumentMarshaler extends ArgumentMarshaler | 
public void set(String s) { 


) 


public Object get() { 
return null; 
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) 
) 


最 后 ， 我 为 integer 类 型 参数 重复 这 个 过 程 。 这 稍稍 复杂 一 点 ， 因 为 integer 需要 解析 ， 
而 parse 操作 会 抛 出 异常 。 不 过 结果 会 更 好 ， 因 为 NumberFormatException 的 概念 在 
IntegerArgumentMarshaler 中 隐藏 了 。 


private boolean isIntArg(char argChar) {return intArgs.containsKey(argChar);] 


) 


e eege E ENEE D Ka H ASIE 


private void setIntArg(char argChar) throws ArgsException {. 


currentArgumenttt; 

String parameter - null; 

try { | 
parameter = args[currentArgument]; 


intArgs.get(argChar).set(parameter); 

} catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 

errorArgumentId = argChar; 

errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 

) catch (ArgsException e) ( 


valid = false; | 
errorArgumentId = argChar; 
errorParameter = parameter; 

errorCode = ErrorCode.INVALID INTEGER; 
throw e; 


} 
} 


private void setBooleanArg(char argChar) { 
try { 
booleanArgs.get (argChar) .set ("true"); 
} catch (ArgsException e) { | l 


} 
} 


public int getInt (char arg) { 
Args.ArgumentMarshaler am = intArgs.get (arg); 
return am == null ? 0 : (Integer) am.get();. 


) 


private abstract class ArgumentMarshaler { 

public abstract void set(String s) throws ArgsException; 
public abstract Object get(); 

| 


private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
private int intValue = 0; 


public void set(String s) throws ArgsException { 
try { 

intValue = Integer.parseInt(s); 

} catch (NumberFormatException e) { 
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throw new ArgsException(); 


} 
} 


public Object get() { 
return intValue; 


) 
) 


测试 当然 继续 通过 。 下 一 步 ， 我 要 删 掉 算法 顶端 的 三 种 不 同 Map。 这 样 ， 整 个 系统 就 变 
得 更 通用 了 。 不 过 ， 只 是 删除 它们 却 无 法 达到 目的 ， 因 为 那样 会 破坏 系统 。 反 之 ， 我 为 
ArgumentMarshaler 添加 一 个 新 的 Map， 然 后 再 逐个 修改 那些 方法 ， 让 方法 调用 这 个 新 Map. 


public class Args { 


private Map<Character, ArgumentMarshaler> booleanArgs = 
new HashMap<Character, ArgumentMarshaler>() ; 

private Map<Character, ArgumentMarshaler> stringArgs 
new HashMap<Character, ArgumentMarshaler>(); | 

private Map<Character, ArgumentMarshaler> intArgs = 
new HashMap<Character,ArgumentMarshaler>(); 

private Map<Character, ArgumentMarshaler> marshalers = 
new HashMap<Character, ArgumentMarshaler>() ; 


li 


private void parseBooleanSchemaElement(char elementId) { 
ArgumentMarshalerm = new BooleanArgumentMarshaler () ; 
booleanArgs.put(elementId, m); 

marshalers.put(elementId, m); 


) 


private void parseIntegerSchemaElement(char elementId) { 
ArgumentMarshaler m = new IntegerArgumentMarshaler () ; 
intArgs.put(elementId, m); 

marshalers.put(elementId, m); 

) 


private void parseStringSchemaElement (char elementId) ( 
ArgumentMarshaler m = new StringArgumentMarshaler () ; 
stringArgs.put (elementId,m) ; 

marshalers.put(elementId, m); 


) 
当然 ， 测 试 还 是 通过 了 。 接 着 ， 我 把 isBooleanArg: 


private boolean isBooleanArg(char argChar) { 
return booleanArgs.containsKey (argChar); 


) 
修改 成 这 样 ， 


private boolean isBooleanArg(char argChar) { 
ArgumentMarshaler m = marshalers.get(argChar); 
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return m instanceof BooleanArgumentMarshaler; 
) 


测试 仍然 通过 。 于 是 我 修改 了 一 下 isIntArg 和 isStringArg. 
private boolean isIntArg(char argChar) { 
ArgumentMarshaler m = marshalers.get(argChar) ; 
return m instanceof IntegerArgumentMarshaler; 
} 


private boolean isStringArg(char argChar) { 
ArgumentMarshaler m = marshalers.get(argChar) ; 
return m instanceof StringArgumentMarshaler; 


} 
测试 继续 通过 。 我 跟着 消除 了 对 marshaler.get 的 重复 调用 : 


private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (isBooleanArg (m) ) 
setBooleanArg (argChar) ; 
else if (isStringArg(m)) 
setStringArg (argChar) ; 
else if (isIntArg(m) ) 
setIntArg(argChar); 
else 
return false; 


return true; 


) 


private boolean isIntArg(ArgumentMarshaler m) { 
return m instanceof IntegerArgumentMarshaler; 


) 


private boolean isStringArg(ArgumentMarshaler m) { 
return m instanceof StringArgumentMarshaler; 

} 

private boolean isBooleanArg(ArgumentMarshaler m) { 
return m instanceof BooleanArgumentMarshaler; 


存在 三 个 isxxxArg 方法 毫 无 道理 。 所 以 我 做 了 内 联 修 改 : 


private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg (argChar); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg (argChar); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg (argChar); 
else 
return false; 


205 


206 第 14 章 逐步 改进 


return true; 


T. 我 开始 在 set 函数 中 使 用 marshaler 映射 停止 使 用 另外 三 个 职员 映射 EE 开始 : 


private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); . 
if (m instanceof 有 
setBooleanArg (m); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg (argChar) ; 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(argChar); 
else 
return false; 


return true; T 


) 


private void setBooleanArg(ArgumentMarshaler m) { 
try { . 
m.set("true"); // was: booleanArgs.get(argChar).set("true"); 
) catch (ArgsException e) { 
) 
) 


测试 通过 ， 于 是 我 如 法 炮制 String 和 Integer 参数 。 这 样 我 就 能 把 有 些 丑 陋 的 异常 管理 代 
码 整 合 到 setArgument 函数 中 。 


private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get (argChar); 
try { 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg (m); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg (m); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg (m); 
else 
return false; 
) catch (ArgsException e) { 
valid = false; 
errorArgumentId = argChar; 
throw e; 
bp 
return true; 


} 


private void setIntArg(ArgumentMarshaler m) throws ArgsException 1{ 


currentArgument-t*; 
String parameter = null; 
try | 
parameter = args[currentArgument]; 


m.set(parameter); 
) catch (ArrayIndexOutOfBoundsException e) { 
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errorCode = ErrorCode.MISSING INTEGER; 
throw new ArgsException(); 
} catch (ArgsException e) { 


errorParameter = parameter; 
errorCode = ErrorCode.INVALID_INTEGER; 
throw e; | 


) 
) 


private void setStringArg(ArgumentMarshaler m) throws ArgsException { 
currentArgumenttt; | 
try { 
m.set(args[currentArgument]); 
) catch (ArrayIndexOutOfBoundsException e) { 
errorCode = ErrorCode.MISSING STRING; 
throw new ArgsException(); 
) 
) 


离 彻 底 删 除 那 3 个 旧 映 射 的 时 机 越 来 越 近 了 。 首 先 ， 我 需要 修改 getBoolean 函数 : 


public boolean getBoolean(char arg). { 


Args.ArgumentMarshaler am = booleanArgs.get (arg); 
return am !- null && (Boolean) am.get(); 

) 

修改 成 这 样 : 

public boolean getBoolean(char arg) { l 

Args.ArgumentMarshaler am = marshalers.get (arg); 
boolean b = false; 

try { 

b = am !- null && (Boolean) am.get(); 

} catch (ClassCastException e) { 

b = false; 

} 

return b; 


/ 


) 
最 后 这 个 修改 可 能 令 人 吃惊 。 为 什么 我 会 突然 决定 对 付 ClassCastException? 原因 是 我 有 
一 组 单元 测试 ， 还 有 用 FitNesse 编写 的 一 组 验收 测试 。FitNesse 测试 确认 ， 如 果 用 非 布 尔 值 
参数 调用 getBoolean; 应 该 返回 false。 可 单元 测试 的 结果 不 是 这 样 。 而 到 此 时 为 止 ， 我 一 直 
只 调用 单元 测试 。 

这 次 修改 把 另 一 个 对 boolean 映射 的 使 用 抽 离 了 : 


private void parseBooleanSchemaElement(char elementId) { 


ArgumentMarshaler m = new BooleanArgumentMarshaler (); 
—beoleanArgs.put(elementid., m), 


marshalers.put(elementId, m); 


) 


Bt, 为 了 避免 这 种 情况 发 生 ， 我 添加 了 一 个 新 的 单元 测试 ， 调 用 所 有 FitNesse 测试 。 
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如 此 我 们 就 能 删除 boolean 映射 。 


public class Args { 





private Map<Character, ArgumentMarshaler> stringArgs 
new HashMap<Character, ArgumentMarshaler>(); 
private Map<Character, ArgumentMarshaler> intArgs = 
new HashMap<Character, ArgumentMarshaler>(); 
private Map<Character, ArgumentMarshaler> marshalers 
new HashMap<Character, ArgumentMarshaler>(); 





接 下 来, 我 用 同样 的 手法 处 理 String 和 Integer 参数 ,对 boolean 参数 做 了 一 点 清理 工作 。 d 


private void parseBooleanSchemaElement(char elementId) { 
marshalers.put(elementId, new BooleanArgumentMarshaler ()); 


) 


private void parseIntegerSchemaElement(char elementId) { 
marshalers.put(elementId, new IntegerArgumentMarshaler ()) ; 
} 





private void parseStringSchemaElement(char elementId) { 
marshalers.put(elementId, new StringArgumentMarshaler () ) ; 
} 


public String getString(char arg) { 
Args.ArgumentMarshaler am = marshalers.get (arg) ; E 


return am -- null ? "" ; (String) am.get(); E 
} catch (ClassCastException e) { 3i 
return ""; SE 
) 
) 
public int getInt(char arg) | | E 
Args.ArgumentMarshaler am = marshalers.get(arg); ` 
try { 

return am == null ? 0 : (Integer) am.get(); 

} catch (Exception e) { 

return 0; 

bo 


) 


public class Args { 

















w=- = - 


private Map<Character, ArgumentMarshaler> marshalers = 
new HashMap<Character, ArgumentMarshaler»(); 






14.3 FIRDA 209 


接着 ， 由 于 那些 parse 方法 没有 太 多 事 可 做 ， 我 对 它们 进行 了 内 联 修改 : 


private void parseSchemaElement(String element) throws ParseException { 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId (elementId); 
i if (isBooleanSchemaElement (elementTail)) 
; marshalers.put(elementId, new BooleanArgumentMarshaler ()) ; 
else if (isStringSchemaElement (elementTail)). 
marshalers.put(elementId, new StringArgumeritMarshaler()); 
else if (isIntegerSchemaElement(elementTail)) ( 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
) else { | | 
throw new ParseException(String.format( | 
"Argument: $c has invalid format: %s.", elementId, elementTail), 0); 


Xem PMT EN o 


) 
) 


行 了 ， 下 面 来 看 看 全 景 吧 。 代 码 清 单 14-12 展示 了 Args 类 的 现状 。 
代码 清单 14-12 Args.java 首次 重 构 后 ) 


package com.objectmentor.utilities.getopts; 








import java.text.ParseException; 
import java.util.*; 


eet Ge en 
| ! f | 


public class Args { 
private String schema; 
private String[] args; 
private boolean valid = true; 
private Set<Character> unexpectedArguments = new TreeSet<Character>(); 
private Map<Character, ArgumentMarshaler> marshalers = 
new HashMap<Character, ArgumentMarshaler>(); 


private Set<Character> argsFound = new HashSet<Character> (); 
private int, currentArgument; 
private char errorArgumentId = '\0'; 


private String errorParameter = "TILT"; 
private ErrorCode errorCode = ErrorCode.OK; 


private enum ErrorCode { 
OK, MISSING STRING, MISSING INTEGER, INVALID INTEGER, UNEXPECTED ARGUMENT) 


public Args (String schema, String[] args) throws ParseException { 


this.schema = schema; 
this.args = args; 
valid = parse(); 


} 


private boolean parse() throws ParseException { 

if (schema.length() == 0 && args.length == Di 
return true; 
parseSchema() ; 
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try { 
parseArguments () ; 
} catch (ArgsException e) { 
} 
return valid; 


) 


private boolean parseSchema() throws ParseException { 


for (String element : schema.split(",")) { 
if (element.length() > 0) { "de | 
String trimmedElement = element.trim(); 


parseSchemaElement (trimmedElement); 
} 
return true; 


, 


private void parseSchemaElement (String element) throws ParseException { 

char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId (elementId); 
if (isBooleanSchemaElement (elementTail)) 

marshalers.put(elementId, new BooleanArgumentMarshaler()); 

else if (isStringSchemaElement (elementTail)) 

marshalers.put(elementId, new StringArgumentMarshaler () ) ; 


else if (isIntegerSchemaElement(elementTail)) ( 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
) else { 


throw new ParseException (String. format 
"Argument: $c has invalid format: %s.", elementId, elementTail), 0); 


) 


private void validateSchemaElementId(char elementId) throws ParseException { 


if (!Character.isLetter(elementId)) ( 
throw new ParseException( 
"Bad character:" + elementId + "in Args format: " + schema, 0); 


) 
) 


private boolean isStringSchemaElement(String elementTail) { 
return elementTail.equals("*"); 


) 


private boolean isBooleanSchemaElement(String elementTail) { 
return elementTail.length() == 0; 


) 


private boolean isIntegerSchemaElement(String elementTail) { 
return elementTail.equals("#"); 


} 


private boolean parseArguments() throws ArgsException { 
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for (currentArgument-0; currentArgument<args.length; currentArgument++) { 
String arg = args[currentArgument]; 
parseArgument (arg) ; 

} 

return true; 


) 


private void parseArgument(String arg) throws ArgsException { 
if (arg.startsWith("-") ) 
parseElements (arg); 


) 


private void parseElements(String arg) throws ArgsException { 
for (int i = 1; i < arg.length(); i++) 
parseElement (arg.charAt (i)); 


} 


private void parseElement(char argChar) throws ArgsException { 
if (setArgument (argChar) ) 
argsFound.add(argChar) ; 
else { 
unexpectedArguments.add(argChar) ; 
errorCode = ErrorCode.UNEXPECTED ARGUMENT; 
valid = false; 


private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get (argChar) ; 
try { | 

if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg (m); 

else if (m instanceof StringArgumentMarshaler) 
setStringArg (m); 

else if (m instanceof IntegerArgumentMarshaler) 
setIntArg (m); 

else l 
return false; 

catch (ArgsException e) { 


Se MP co onam 


yt . 





à valid - false; 

3 errorArgumentId = argChar; 

E throw e; 

3 return true; 

E private void setIntArg(ArgumentMarshaler m) throws ArgsException { 
E currentArgument++; 

r Strin ter - null; 

人 g parameter null; 

L try { 

E parameter = args[currentArgument]; 


m.set (parameter); 
} catch (ArrayIndexOutOfBoundsException e) { 
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errorCode. » ErrorCode.MISSING INTEGER; 
throw new ArgsException(); 
} catch (ArgsException e) | 


errorParameter = parameter; 
errorCode = ErrorCode.INVALID INTEGER; 
throw e; 


) 
) 


private void setStringArg(ArgumentMarshaler m) throws ArgsException { 
currentArgumenttt; 
try { 
m.set (args[currentArgument]); 
) catch (ArrayIndexOutOfBoundsException e) ( 
errorCode = ErrorCode.MISSING STRING; 
throw new ArgsException(); 
) 
) 


private void setBooleanArg(ArgumentMarshaler m) { 
try { 
m.set ("true"); 

} catch (ArgsException e) { 

} 


public int cardinality() { 
return argsFound.size(); 


) 


public String usage() { 
if (schema.length() > 0) 


return "-[" + schema + "Jj"; 
else 
return ""; 


) 


public String errorMessage() throws Exception { 
switch (errorCode) { 
case OK: 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED ARGUMENT: 
= return unexpectedArgumentMessage () ; 
case MISSING_STRING: 
return String,format("Could not find string parameter for -%c.", 
errorArgumentId); 
case INVALID INTEGER: 
return String.format ("Argument -$c expects an integer but was 'S$s'.", 
errorArgumentId, errorParameter) ; 
case MISSING INTEGER; 
return String.format("Could not find integer parameter for -$c.", 
errorArgumentId); 


return ""; 


) 


private String unexpectedArgumentMessage() | 


StringBuffer message = new StringBuffer ("Argument (s) 


for (char c : unexpectedArguments) ( 
message.append(c); 


) 


message.append(" unexpected."); 


return message.toString(); 


) 


public boolean getBoolean(char arg) { 


Args.ArgumentMarshaler am = marshalers.get(arg); 
boolean b = false; 
try { 
b = am != null && (Boolean) am.get(); 
) catch (ClassCastException e) { | 
b = false; 
) 
return b; 


) 


public String getString(char arg) | 


Args.ArgumentMarshaler am = marshalers.get(arg); 
try ( 

return am == null ? "" : (String) am.get(); 
) catch (ClassCastException e) ( 

return ""; 


) 
) 


public int getInt(char arg) { 


Args.ArgumentMarshaler am = marshalers.get(arg); 
try { | | 
return am == null ? 0 : (Integer) am.get(); 


) catch (Exception e) { 
return 0; 
) 
) 


public boolean has(char arg) { 
return argsFound.contains (arg); 


) 


public boolean isValid() { 
return valid; 


) 


private class ArgsException extends Exception | 


) 
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private abstract class ArgumentMarshaler { 
public abstract void set(String s) throws ArgsException; 
public abstract Object get(); | 

) 


private class BooleanArgumentMarshaler extends ArgumentMarshaler { 
private boolean booleanValue - false; 


public void set(String s) | 
booleanValue = true; 
) 


public Object get() { 
return booleanValue; 
} 
) : 


private class StringArgumentMarshaler extends ArgumentMarshaler { 
private String stringValue = ""; | 


public void set(String s) { 
stringValue = S; 


) 


public Object get() { 
return stringValue; 
) 
) 


private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
private int intValue = 0; 


public void set(String s) throws ArgsException { 
try { 
intValue = Integer.parseInt(s); 
} catch (NumberFormatException e) { 
throw new ArgsException() ; 
} 
) 


public Object get() ( 
return intValue; 
) 
) 
) 


功夫 费 尽 ， 还 是 有 点 失望 。 程 序 结构 好 了 一 点 ， 但 在 代码 顶端 还 是 有 那 一 堆 变 量 ， 在 
setArgument 里 面 还 是 有 那么 恐怖 的 类 型 转换 操作 ;， 而且 那 些 set 函数 真 的 很 丑陋 。 就 别提 和 那 
些 错 误 处 理 操作 了 。 前 头 要 做 的 事 还 很 多 。 | 
| 我 真是 想 删 掉 setArgument 里 面 那些 类 型 转换 操作 [G23]。 我 想 要 setArgument 只 简单 地 

调用 ArgumentMarshaler.set。 这 意味 着 我 需要 将 setIntArg、setStringArg 和 setBooleanArg 推 到 
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的 ArgumentMarshaler 派生 类 里 面 。 不 过 这 有 个 问题 。 

仔细 看 setIntArg, 你 会 发 现 , 它 使 用 了 两 个 实体 变量 ; args 和 currentArg。 为 了 把 setIntArg 
| BooleanARgumentMarshaler 里 面 ,我 得 把 这 两 个 变量 都 作为 函数 参数 传递 过 去 。 那 种 做 
烂 了 [下 1]。 我 只 想 传递 一 个 参数 。 幸 运 的 是 ， 有 个 简单 的 解决 方法 。 可 以 把 args MAR 
一 个 list， 并 向 set 函数 传递 一 个 Iterator. RET K 10 步 功 夫 ， 每 次 都 通过 了 测试 。 不 
只 向 你 展示 结果 。 你 应 该 能 看 出 每 个 小 修改 步骤 。 


public class Args { 
private String schema; 
—private—Stringl]—argse 
private boolean valid = true; 
private Set<Character> unexpectedArguments = new TreeSet«Character»(); 
private Map<Character, ArgumentMarshaler> marshalers = 
new  HashMap«Character, ArgumentMarshaler>(); 


private Set<Character> argsFound = new HashSet<Character>(); 
private -Iterator<String> currentArgument; 
private char errorArgumentId = '\0'; 
private String errorParameter = "TILT"; 
private ErrorCode errorCode = ErrorCode.OK; 
: private List<String> argsList; 
- ` 
= private enum ErrorCode { 
a OK, MISSING STRING, MISSING INTEGER, INVALID INTEGER, UNEXPECTED ARGUMENT) 
3 public Args (String schema, String[] args) throws ParseException { 
E. this.schema - schema; 
E. argsList = Arrays.asList(args) ; 
a valid = parse(); 
Es 
2 
x private boolean parse() throws ParseException { 
d if (schema.length() == 0 EE argsList.size() == 0) 
a return true; | 
p parseSchema(); 
3 try { 
a parseArguments (); 


} catch (ArgsException e) { 
) 
return valid; 
) 
private boolean parseArguments() throws ArgsException { 
for (currentArgument = argsList.iterator() ;currentArgument.hasNext();) { 
String arg = currentArgument.next(); 
parseArgument (arg); 


retun true; 
} 
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private void setlIntArg(ArgumentMarshaler m) throws ArgsException { 


String parameter = null; 
try { 
parameter = currentArgument.next(); 


m.set (parameter) ; 

} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 

} catch (ArgsException e) { 


errorParameter = parameter; 
errorCode = ErrorCode.INVALID INTEGER; 
throw e; l 


} 
} 


private void setStringArg(ArgumentMarshaler m) throws ArgsException ( 
try { 
m.set(currentArgument.next()); 
) catch (NoSuchElementException e) | 
errorCode = ErrorCode.MISSING STRING; 
throw new ArgsException(); 
) 
) 


是 这 些 简单 的 修改 让 测试 保持 通过 。 现 在 我 们 可 以 开始 把 set 函数 移植 到 合适 的 派生 类 
中 了 。 第 一 步 ， 我 要 在 setArgument 中 做 以 下 修改 : 


private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get (argChar); 
if (m == null) ` 
return false; 
try { 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg (m); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg (m); | 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg (m); 
— —else 
— ———sreturn—false; 
} catch (ArgsException e) { 
valid = false; 
errorArgumentId = argChar; 
throw e; 
} 


return true; 


| | 
这 个 修改 很 重要 ， 因 为 我 们 想 要 彻底 删除 那 条 if-else 链 。 所 以 ， 需 要 把 错误 条 件 抽 离 。 


现在 可 以 开始 移动 set MAS. setBooleanArg 函数 很 小 ， 就 从 它 开始 。 目 标 是 让 
setBooleanArg 函数 只 与 BooleanArgumentMarshaler 有 关 。 


private boolean setArgument(char argChar) throws ArgsException ( 
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ArgumentMarshaler m = marshalers.get (argChar); 
if (m == null) 
return false; 
try { 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(m, currentArgument); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg (m); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg (m); 
) catch (ArgsException e) { 
valid = false; P 
errorArgumentId = argChar; 
throw e; 


) 


return true; 


) 


private void setBooleanArg(ArgumentMarshaler m, 
Iterator<String> currentArgument) 
throws ArgsException { 


try—t 


m.set ("true"); 
eateh—(ArgsException—e)—1 
ec 
) 


我 们 不 是 刚 把 那个 异常 处 理 放 进去 吗 ? 放 进 拿 出 是 重 构 过 程 中 常见 的 事 。 小 步 幅 和 保持 
测试 通过 ， 意 味 着 你 会 不 断 移动 各 种 东西 。 重 构 有 点 像 是 解 魔方 。 需 要 经 过 许多 小 步骤 ， 才 
能 达到 较 大 目标 。 每 一 步 都 是 下 一 步 的 基础 。 

为 什么 要 在 setBooleanArg 根本 不 需要 的 情况 下 癌 其 传递 iterator E? 因为 setIntArg 和 
setStringArg 需要 ! 还 因为 我 打算 通过 ArgumentMarshaler 中 的 抽象 方法 部 署 这 三 个 函数 ， 需 
要 将 其 传递 给 setBooleanArg. 

现在 setBooleanArg 没 用 了 。 如 果 ArgumentMarshaler 中 有 个 set 函数 ， 我 们 可 以 直接 调 
用 它 。 是 时 候 打 造 那 个 函数 了 ! 第 一 步 ， 在 ArgumentMarshaler 中 添加 抽象 方法 。 


private abstract class ArgumentMarshaler { : 
public abstract void set(Iterator<String> currentArgument) 
throws ArgsException; 
public abstract void set(String s) throws ArgsException; 
public abstract Object get(); 
) 


当然 ， 这 会 影响 到 所 有 派生 类 。 所 以 ， 要 逐个 实现 新 方法 。 


private class BooleanArgumentMarshaler extends ArgumentMarshaler | 
private boolean booleanValue = false; 


public void set(Iterator<String> currentArgument) throws ArgsException { 
booleanValue = true; 
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public void set(String s) { 


-—— — beoiesnValue —s——brue- 
) 


public Object get() { 
return booleanValue; 


) 
} 


private class StringArgumentMarshaler extends ArgumentMarshaler { 
private String stringValue = ""; 


public void set(Iterator<String> currentArgument) throws ArgsException { 
, | 


public void set(String s) { 
stringValue = s; 
} 


public Object get() { 
return stringValue; 


} 
} 


private class IntegerArgumentMarshaler extends ArgumentMarshaler ( 
private int intValue = 0; 


public void set(Iterator<String> currentArgument) throws ArgsException { 


public void set(String s) throws ArgsException { 
try { 

intValue = Integer.parseInt(s); 

} catch (NumberFormatException e) { 

throw new ArgsException(); 


) 
) 


public Object get() { 
return intValue; 

) 

) 


现在 可 以 删除 setBooleanArg J ! 


private boolean setArgument(char argCnar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m == null) 
return false; 
try { 
if (m instanceof BooleanArgumentMarshaler) 
m.set(currentArgument); 
else if (m instanceof StringArgumentMarshaler) 
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setStringArg (m); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg (m); 
} catch (ArgsException e) { 
valid = false; 
errorArgumentId = argChar; 
throw e; 
} 
return true; 


} 
测试 全 都 通过 ， 而 且 set 函数 也 部 署 到 BooleanArgumentMarshaler 里 面 了 ! 
现在 就 能 对 String 和 Integer 参数 的 处 理 做 同样 的 修改 。 | 


private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get (argChar) ; 
if (m == null) 
return false; 


try { 
if (m instanceof BooleanArgumentMarshaler) 


m.set (currentArgument) ; 
else if (m instanceof StringArgumentMarshaler) 
m.set (currentArgument) ; 
else if (m instanceof IntegerArgumentMarshaler) 
m. set (currentArgument) ; 
} catch (ArgsException e) { 
valid = false; 
errorArgumentId = argChar; 
throw e; | | 
) 
return true; 


]--- 


private class StringArgumentMarshaler extends ArgumentMarshaler { 
= "n". 


private String stringValue - 


public void set(Iterator<String> currentArgument) throws ArgsException { 


try { 
stringValue = currentArgument.next() ; 

} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING_STRING; 


throw new ArgsException () ; 


} 
} 


public void set(String s) { 
} 


public Object get() { 
return stringValue; 


} 
} 


private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
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severe int intValue = 0; 


public void set(Iterator<String> currentArgument) throws ArgsException { 


String parameter = null; 

try { 
parameter = currentArgument.next() ; 
set (parameter) ; 

} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING INTEGER; 
throw new ArgsException(); 

) catch (ArgsException e) { 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID INTEGER; 
throw 6; | 
} 

A 

public void set(String s) throws ArgsException { 
try ( 
intValue = Integer.parseInt(s); 

) catch (NumberFormatException e) { 
throw. new ArgsException(); 

) 

) 


public Object get() { 
return intValue; 

) 

) 


最 后 一 击 : 可 以 移 除 类 型 转换 了 1! 看 招 ! 


private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get (argChar); 
if (m -- null) 
return false; 
try { 
m.set (currentArgument) ; 
return true; 
} catch (ArgsException e) { 
valid = false; 
errorArgumentId = argChar; 
throw e; 
) 
) 


现在 可 以 删 掉 IntegerArgumentMarshaler 中 那些 过 时 的 函数 ， 做 一 下 清理 了 。 


private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
private int intValue = 0 


public void set(Iterator<String> currentArgument) throws ArgsException | 
String 

parameter = null; 
try { 
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parameter = currentArgument.next(); 
intValue = Integer.parseInt (parameter); 
} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 
} catch (NumberFormatException e) | 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID INTEGER; 
throw new ArgsException(); 
) 
) 


public Object get() { 
return intValue; 
) 
】 


还 可 以 把 ArgumentMarshaler 修改 为 接口 。 


private interface ArgumentMarshaler { 

void set(Iterator<String> currentArgument) throws ArgsException; 
Object get(); | 

) 


现在 来 看 看 往 这 个 结构 中 添加 新 的 参数 类 型 有 多 容易 。 只 需要 做 少量 修改 ， 而 且 修 改 是 
被 隔离 的 。 首 先 ， 增 加 一 个 新 的 测试 用 例 ， 检 测 double 参数 是 否 正常 工作 。 


public void testSimpleDoublePresent() throws Exception 1{ 
Args args = new Args("x##", new String[] ("-x","42.3")); 
assertTrue (args.isValid()); 
assertEquals(1, args.cardinality()); 
assertTrue(args.has('x')); 
assertEquals(42.3, args.getDouble('x'), .001); 


) 
然后 清理 范式 解析 代码 ， 为 double SARA DH EN. 


private void parseSchemaElement(String element) throws ParseException { 
char elementId = element.charAt (0); 
String elementTail = element.substring(1); 
validateSchemaElementId (elementId); 
if (elementTail.length() == 0) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (elementTail.equals("*") ) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (elementTail.equals ("#") ) 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 


else if (elementTail.equals ("##") ) 
marshalers.put(elementId, new DoubleArgumentMarshaler ()); 
else 
throw new ParseException (String. format ( f 
"Argument: $c has invalid format: %s.", elementId, elementTail), 0); 
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下 一 步 ， 编写 DoubleArgumentMarshaler 类 。 


private class DoubleArgumentMarshaler implements ArgumentMarshaler ( 
private double doubleValue = 0; 


public void set(Iterator4«String» currentArgument) throws ArgsException ( 
String parameter = null; 
try 1{ 
parameter = currentArgument.next() ; 
doubleValue = Double.parseDouble (parameter) ; 
} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING DOUBLE; 
throw new ArgsException () ; 
} catch (NumberFormatException e) { 
errorParameter = parameter; 
errorCode = ErrorCode. INVALID DOUBLE; 
throw new ArgsException () ; 
} 
} 


public Object get() { 
return doubleValue; 
} 

} 


然后 就 得 添加 一 个 新 的 ErrorCode: 


private enum ErrorCode { 


OK, MISSING STRING, MISSING INTEGER, INVALID INTEGER, UNEXPECTED ARGUMENT, 
MISSING DOUBLE, INVALID DOUBLE) 


还 需要 一 个 getDouble HA: 


public double getDouble(char arg) { 
Args.ArgumentMarshaler am - marshalers.get(arg); 


try { 

return am -- null ? 0 : (Double) am.get(); 
} catch (Exception e) ( 

return 0.0; Jf 


) 
) 


全 部 测试 都 通过 了 ! 完全 无 痛 。 再 来 确保 全 部 错误 处 理 代码 正确 工作 。 下 一 个 测试 用 例 
用 来 检测 在 向 闪 参 数 传递 一 个 不 可 解析 的 字符 串 时 是 否 会 返回 错误 。 


public void testInvalidDouble() throws Exception { 

Args args = new Args("x##", new String[] ("-x","Forty two")); 

assertFalse(args.isValid()); 

assertEquals(0, args.cardinality()); 

assertFalse(args.has('x')); 

assertEquals(0, args.getInt('x')); 

assertEquals("Argument -x expects a double but was 'Forty two'.", 
args.errorMessage()); 


143 字符 串 参 数 223 


public String errorMessage() throws Exception { 
switch (errorcode) | 
case OK: 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED ARGUMENT: 
return unexpectedArgumentMessage(); 
case MISSING STRING: 
return String.format("Could not find string parameter for -%c.", 
errorArgumentId); 
case INVALID INTEGER: 
return String.format ("Argument -%c expects an integer but was '$s'.", 
errorArgumentId, errorParameter) ; 
case MISSING_INTEGER: 
return String.format("Could not find integer parameter for ~-%c.", 
errorArgumentId) ; 
case INVALID_DOUBLE: . 
return String.format ("Argument -%c expects a double but was '‘'%s'.", 
errorArgumentId, errorParameter) ; 
case MISSING DOUBLE: 
return String.format("Could not find double parameter for -$c.", — 
errorArgumentId); ; 
) 
return ""; 


} 
测试 通过 。 下 一 个 测试 确保 我 们 正确 检测 到 遗漏 的 double 参数 。 


public void testMissingDouble() throws Exception | 
Args args = new Args("x##", new String[]("-x")); 
assertFalse (args.isValid()); 
assertEquals(0, args.cardinality()); 
assertFalse (args.has('x')); 
assertEquals(0.0, args.getDouble('x'), 0.01); 
assertEquals("Could not find double parameter for -x.", 

args.errorMessage()); 


} 

测试 如 期 通过 ， 我 们 只 是 为 了 保持 一 切 完整 而 编写 这 个 测试 。 | 

异常 代码 很 丑陋 ， 不 该 在 Args 类 中 存在 。 我 们 也 抛 出 ParseException， 但 那 并 不 真 的 属 
于 我 们 自己 。 那 就 把 所 有 异常 都 塞 到 ArgsException 类 中 ， 并 将 其 移 到 它 自己 的 模块 里 面 。 


public class ArgsException extends Exception | 


private char errorArgumentId = '\0'; 
private String errorParameter = "TILT"; 
private ErrorCode errorCode = ErrorCode.OK; 


public ArgsException() {} 
public ArgsException (String message) {super (message) ; } 
public enum ErrorCode { 


OK, MISSING STRING, MISSING INTEGER, INVALID INTEGER, UNEXPECTED_ARGUMENT, 
MISSING DOUBLE, INVALID DOUBLE) 
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public class Args ( 


private char errorArgumentId = '\0'; 


private String errorParameter = "TILT"; 
private ArgsException.ErrorCode errorCode = ArgsException.ErrorCode.OK; 


private .List<String> argsList; 


public Args(String schema, String[] args) throws ArgsException { 
this.schema = schema; 
argsList = Arrays.asList(args); 
valid = parse(); 

) 


private boolean parse() throws ArgsException { 

if (schema.length() == 0 && argsList.size() == 0) 
return true; 

parseSchema(); 

try { 
parseArguments(); 

) catch (ArgsException e) ( 

) 

return valid; 


) 


private boolean parseSchema() throws ArgsException { 


) 


private void parseSchemaElement(String element) throws ArgsException 


else 
throw new ArgsException ( 
String.format("Argument: $c has invalid format: Se", 
elementId,elementTail)); 


) 


private void validateSchemaElementId (char elementId) throws ArgsException 


if (!Character.isLetter(elementId)) { 
throw new ArgsException ( 


"Bad character:" + elementId + "in Args format: " + schema); 


private void parseElement(char argChar) throws ArgsException | 
if (setArgument (argChar)) 
argsFound.add(argChar); | 
else { 
unexpectedArguments.add(argChar) ; 
errorCode = ArgsException.ErrorCode.UNEXPECTED_ ARGUMENT; 
valid = false; 


{ 
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private class StringArgumentMarshaler implements ArgumentMarshaler { 
private String stringValue = ""; 


public void set(Iterator<String> currentArgument) throws ArgsException { 
try { 
stringValue = currentArgument.next(); 
} catch (NoSuchElementException e) ( 
errorCode = ArgsException.ErrorCode.MISSING STRING; 
throw new ArgsException();' 
) 
) 


public Object get() { 
return stringValue; 
) 


private class IntegerArgumentMarshaler implements ArgumentMarshaler { 
private int intValue = 0; 


' public void set(Iterator<String> currentArgument) throws ArgsException { 


String parameter = null; 

try { 
parameter = currentArgument.next(); 
intValue = Integer.parseInt (parameter); 


} catch (NoSuchElementException e) { 
errorCode = ArgsException.ErrorCode.MISSING INTEGER; 
throw new ArgsException(); 

catch (NumberFormatException e) { 
errorParameter = parameter; 
errorCode = ArgsException.ErrorCode.INVALID INTEGER; 
throw new ArgsException () ; 

} 

} 


w 


public Object get() { 
return intValue; 
) 
) 


private class DoubleArgumentMarshaler implements ArgumentMarshaler { 
private double doubleValue = 0; 


public void set (Iterator<String> currentArgument) throws ArgsException { 


String parameter = null; 
try { 
parameter = currentArgument.next(); 


doubleValue = Double.parseDouble (parameter) ; 


225 


226 第 14 章 逐步 改进 


} catch (NoSuchElementException e) { 
errorCode = ArgsException.ErrorCode.MISSING, DOUBLE; 
throw new ArgsException(); 

) catch (NumberFormatException e) { 
errorParameter = parameter; 
errorCode = ArgsEsxception.ErrorCode.INVALID DOUBLE; 
throw new ArgsException(); 

) 

) 


public Object get() { 
return doubleValue; 
Su 
很 好 。 现 在 ，Args 抛 出 的 唯一 一 个 异常 是 ArgsException。 把 ArgsException 移 到 它 自己 
的 模块 中 ， 意 味 着 我 们 能 把 大 量 杂 七 杂 八 的 错误 支持 代码 从 Args 模块 转移 到 这 个 模块 。 
现在 我 们 完全 把 异常 和 错误 代码 从 Args 模块 中 隔离 出 来 了 。( 如 代码 清单 14-13~16 所 


示 。) 为 达到 这 一 目标 ， 大 概 做 了 30 次 小 修改 ， 每 次 修改 都 保持 测试 通过 。 


代码 清单 14-13 ArgsTest.java 


package com.objectmentor.utilities.args; 





import junit.framework.TestCase; 


public class ArgsTest extends TestCase { 

public void testCreateWithNoSchemaOrArguments() throws Exception { 
Args args = new Args("", new String[0]); 
assertEquals(0, args.cardinality()); 


) 


public void testWithNoSchemaButWithOneArgument() throws Exception { 
try { 
new Args("", new String[]{"-x"}); 
fail(); 
) catch (ArgsException e) { 
assertEquals (ArgsException.ErrorCode.UNEXPECTED | ARGUMENT, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentId()); 
) 
} 


public void testWithNoSchemaButWithMultipleArguments() throws Exception { 
try { 
new Args("", new String[{]{"-x", "-y"}); 
fail(); 
} catch (ArgsException e) { 
assertEquals (ArgsException.ErrorCode.UNEXPECTED_ARGUMENT, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentId()); 
) 
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) 


public void testNonLetterSchema() throws Exception { 
try f 
new Args("*", new String[]{}); 
fail("Args constructor should have thrown exception"); 
} catch (ArgsException e) { 
assertEquals (ArgsException.ErrorCode.INVALID ARGUMENT, NAME, 
e.getErrorCode()); 
assertEquals('*', e.getErrorArgumentId()); 
) l 
} 


public void testInvalidArgumentFormat() throws Exception { 
try { 
new Args("f-", new String[]{}); 
fail("Args constructor should have throws exception"); 
} catch (ArgsException e) { 
assertEquals (ArgsException.ErrorCode.INVALID FORMAT, e.getErrorCode()); 
assertEquals('f', e.getErrorArgumentId()); 
) 
) 


public void testSimpleBooleanPresent() throws Exception { 
Args args = new Args("x", new String[]{"-x"}); 
assertEquals(l, args.cardinality()); 
assertEquals(true, args.getBoolean('x')); 

) 


public void testSimpleStringPresent() throws Exception { 
Args args = new Args("x*", new String[]("-x", "param"]); 
assertEquals(1, args.cardinality()); 
assertTrue (args.has('x')); 
assertEquals("param", args.getString('x')); 


) 


public void ,testMissingStringArgument() throws Exception { 
try { 
new Args("x*", new String[]("-x")); 
fail(); 
} catch (ArgsException e) { 
assertEquals (ArgsException.ErrorCode.MISSING_STRING, e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentId()); 
) 
F: 


public void testSpacesInFormat() throws Exception { 
Args args = new Args("x, y", new String[]{"-xy"}); 
assertEquals(2, args.cardinality()); 
assertTrue (args.has('x')); 
assertTrue (args.has('y')); 

} 


public void testSimpleIntPresent() throws Exception { 
Args args = new Args("x#", new String[]{"-x", "42"}); 
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} 





assertEquals(1, args.cardinality()); 

assertTrue (args.has ('x')); 

assertEquals(42, args.getInt('x')); 
} 


public void testInvalidInteger() throws Exception { 
try { 
new Args("x#", new String[]("-x", "Forty two"}); 
fail(); 
} catch (ArgsException e) { 
assertEquals (ArgsException.ErrorCode.INVALID INTEGER, 
assertEquals('x', e.getErrorArgumentId()); 
assertEquals("Forty two", e.getErrorParameter()); 
: 
) 


public void testMissingInteger() throws Exception { 
try { 
new Args("x#", new String[]("-x")); 
fail(); 
} catch (ArgsException e) { 
assertEquals (ArgsException.ErrorCode.MISSING INTEGER, 
assertEquals('x', e.getErrorArgumentId()); 
| 
) 


public void testSimpleDoublePresent() throws Exception 
Args args = new Args("x##", new String[]{"-x", "42 
assertEquals(1, args.cardinality()); 
assertTrue (args.has ('x')); 
assertEquals(42.3, args.getDouble('x'), .001); 

} 


public void testInvalidDouble() throws Exception { 
try { 
new Args("x##", new String[]("-x", "Forty two")); 
fail(); 
} catch (ArgsException e) { 
assertEquals (ArgsException.ErrorCode.INVALID DOUBLE, 
assertEquals('x', e.getErrorArgumentId()); 
assertEquals ("Forty two", e.getErrorParameter()); 
) 
) 


public void testMissingDouble() throws Exception { 
try { 
new Args("x##", new String[]("-x")); 
fail(); 
} catch (ArgsException e) { 
assertEquals (ArgsException.ErrorCode.MISSING DOUBLE, 
assertEquals('x', e.getErrorArgumentId()); 
) 
) 


e.getErrorCode()); 


e.getErrorCode()); 


{ 


.3"}); 


e.getErrorCode()); 


e.getErrorCode()); 
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代码 清单 14-14 ArgsExceptionTest.java 


public class ArgsExceptionTest extends TestCase { 
public void testUnexpectedMessage() throws Exception { 
ArgsException e - 
new ArgsException(ArgsException.ErrorCode.UNEXPECTED | ARGUMENT, 
'x', null); 
assertEquals("Argument -x unexpected.", e.errorMessage()); 


) 


public void testMissingStringMessage() throws Exception { 
ArgsException e = new RESSERCODETOD pcept Lon ErrorCode.MISSING STRING, 
'x', null); 
NEE not find string parameter for -x.", ee 


} 


public void testInvalidIntegerMessage() throws Exception { 
ArgsException e - 
new ArgsException(ArgsException.ErrorCode.INVALID INTEGER, 
'x', "Forty two"); 
assertEquals("Argument -x expects an integer but was 'Forty two'." 
e.errorMessage()); 


) 


public void testMissingIntegerMessage() throws Exception { 
ArgsException e = new ArgsException(ArgsException.ErrorCode.MISSING INTEGER, 
'x', null); 
assertEquals("Could not find integer parameter for -x.", e.errorMessage()); 
) 


public void testInvalidDoubleMessage() throws Exception { 
ArgsException e = new ArgsException(ArgsException.ErrorCode.INVALID DOUBLE, 
| 'x', "Forty two"); - 
assertEquals ("Argument -x expects a double but was 'Forty two'.", 
e.errorMessage()); 
) 
public void testMissingDoubleMessage() throws Exception { 
ArgsException e = new ArgsException(ArgsException.ErrorCode.MISSING, DOUBLE, 
'x', null); 
assertEquals("Could not find double parameter for -x.", e.errorMessage()); 
) 


代码 清单 14-15 ArgsException java 


public class ArgsException extends Exception { 


private char errorArgumentId = '\0'; 
private String errorParameter = "TILT"; 
private ErrorCode errorCode = ErrorCode.OK; 


public ArgsException() {} 


public ArgsException(String message) {Super (message) ;} 
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public ArgsException(ErrorCode errorCode) ( 
this.errorCode = errorCode; 


) 


public ArgsException(ErrorCode errorCode, String errorParameter) ( 
this.errorCode = errorCode; | 
this.errorParameter = errorParameter; 


) 


public ArgsException (ErrorCode errorCode, char errorArgumentId, 
String errorParameter) { 


this.errorCode = errorCode; 
this.errorParameter = errorParameter; 


this.errorArgumentId = errorArgumentId; ‘ 


) 


public char getErrorArgumentId() { 
return errorArgumentId; 


} 


public void setErrorArgumentId(char errorArgumentId) { 
this.errorArgumentId = errorArgumentId; 


) 


public String getErrorParameter() { 
return errorParameter; 


) 


public void setErrorParameter(String errorParameter) ( 
this.errorParameter = errorParameter; 


) 


public ErrorCode getErrorCode() { 
return errorCode; 


) 


public void setErrorCode(ErrorCode errorCode) { 
this.errorCode = errorCode; 


) 


public String errorMessage() throws Exception { 
switch (errorCode) { 
case OK: 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED_ARGUMENT: 
return String.format("Argument -$c unexpected.", errorArgumentId) ; 
case MISSING_STRING: 
return String.format("Could not find string parameter for -$c.", 
errorArgumentId); 
case INVALID INTEGER: 
return String.format("Argument -%c expects an integer but was '$s'.", 
errorArgumentId, errorParameter) ; 
case MISSING_INTEGER: 
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return String.format("Could not find integer parameter for -$c.", 
ED errorArgumentId); 
case INVALID DOUBLE: 
return String.format("Argument -%c expects a double but was '$s'.", 
errorArgumentId, errorParameter) ; 


case MISSING_DOUBLE: 
return String.format("Could not find double parameter for -$c.", 
errorArgumentId); 
) 
return ""; 


) 


public enum ErrorCode { 
OK, INVALID FORMAT, UNEXPECTED ARGUMENT, INVALID ARGUMENT NAME, 
MISSING, STRING, 
MISSING INTEGER, INVALID INTEGER, 
MISSING DOUBLE, INVALID DOUBLE) 


代码 清单 14-16 Args.java 


public class Args { 
private String schema; 
private Map<Character, ArgumentMarshaler> marshalers = 
new HashMap<Character, ArgumentMarshaler>(); 
private Set<Character> argsFound = new HashSet<Character>(); 
private Iterator<String> currentArgument; 
private List<String> argsList; 


public Args(String schema, String[] args) throws ArgsException { 


this.schema = schema; 
argsList = Arrays.asList (args); 
parse(); 


} 


private void parse() throws ArgsException { 
parseSchema () ; 


parseArguments(); 

) 

private boolean parseSchema() throws ArgsException { 
for (String element : schema.split(",")) { 


if (element.length() > 0) { 
parseSchemaElement (element.trim()); 
} 
} 
return true; 


} 


private void parseSchemaElement (String element) throws ArgsException { 
char elementId = element.charAt (0); 
String elementTail = element.substring(1); 
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validateSchemaElementId (elementId); 
if (elementTail.length() == 0) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (elementTail.equals ("*")) ; : 
marshalers.put(elementId, new EE EE | 
else if (elementTail.equals("#")) 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
else if (elementTail.equals ("##") ) 
marshalers.put(elementId, new DoubleArgumentMarshaler ()); 
else 
throw new ArgsException(ArgsException.ErrorCode.INVALID FORMAT, 
elementId, elementTail); 


) 


private void validateSchemaElementId(char elementId) throws ArgsException { 
if (!Character.isLetter(elementId)) { i 
throw new ArgsException (ArgsException.ErrorCode.INVALID_ARGUMENT_NAME, 
elementId, null); 
) 
) 


private void parseArguments() throws ArgsException { 
for (currentArgument = argsList.iterator(); currentArgument.hasNext();) ( 
String arg = currentArgument.next(); 
parseArgument (arg); 
) 
) 


private void parseArgument(String arg) throws ArgsException { 
if (arg.startsWith("-")) 
parseElements (arg); 


) 


private void parseElements(String arg) throws ArgsException { 
for (int i = 1; i < arg.length(); i++) 
parseElement (arg.charAt (1)); 


) 


private void parseElement(char argChar) throws ArgsException (| 
if (setArgument (argChar)) 
argsFound.add(argChar) ; 


else { 
throw new ArgsException (ArgsException. ErrorCode.UNEXPECTED_ARGUMENT, 


argChar, null); 
} 
} 


private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m =  marshalers.get (argChar); 
if (m == null) | 
return false; 
try { 
m.set (currentArgument) ; 
return true; 
} catch (ArgsException e) { 


e.setErrorArgumentId (argChar); 
throw e; 
} 
} 


public int cardinality() { 
return argsFound.size(); 


} 


public String usage() { 
if (schema.length() > 0) 
return "-[" + schema + "J"; 
else 
return ""; 


) 


public boolean getBoolean(char arg) 


ArgumentMarshaler am = marshalers.get (arg); 
boolean b = false; 
try { E 

b = am != null && (Boolean) am.get(); 


} catch (ClassCastException e) { 
b - false; 

) 

return b; 


) 


public String getString(char arg) 1 


ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am -- null ? "" ; (String) 


} catch (ClassCastException e) { 
return ""; 
) 
) 


public int getInt(char arg) { 


ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am == null ? 0 : (Integer) 


} catch (Exception e) .I 
return 0; 
} 
} 


public double getDouble(char arg) { 


ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am == null ? 0 : (Double) 


} catch (Exception e) { 
return 0.0; 


) 


( 
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} 


public boolean has(char arg) { 
return argsFound.contains (arg); 
) 
) 


对 Args 类 所 做 的 最 主要 的 修改 是 在 监测 部 分 。 从 Ars 里 面 取 出 了 大 量 代 码 ， 放 到 
ArgsException 中 。 很 好 。 我 们 还 把 全 部 ArgumentMarshaler 转移 到 了 它们 自己 的 文件 中 。 更 好 ! 

优秀 的 软件 设计 ， 大 都 关乎 分 隔 一 一 创建 合适 的 空间 放置 不 同 种 类 的 代码 。 对 关注 面 的 
分 隔 让 代码 更 易于 理解 和 维护 。 

特别 有 意思 的 是 ArgsException 中 的 errorMessage 方法 。 显 然 ， 把 错误 信 息 格 式 化 操作 放 
在 Args Bi, ERT SRP 原则 。Args 应 该 只 处 理 参数 ， 不 该 去 管 错误 信息 的 格式 。 然 而 ， 
把 错误 信息 格式 化 代码 放 到 ArgsException FEFA EAE? 

实话 说 , 这 是 种 折衷 做 法 。 不 打算 用 ArgsException 提供 的 错误 信息 的 用 户 会 想 自己 写 错 
误 信 息 。 但 如 果 有 备 好 的 错误 信息 ， 其 方便 之 处 也 并 非 鲜 见 。 

现在 ， 显 然 我 们 已 经 非常 接近 本 章 开始 处 所 展示 的 最 终 解 决 方案 了 。 最 后 的 工作 留 给 你 
来 练习 完成 。 


14.4 小 结 


代码 能 工作 还 不 够 。 能 工作 的 代码 经 常会 严重 裔 省。 满足 于 仅仅 让 代码 能 工作 的 程序 员 
不 够 专业 。 他 们 会 害怕 没 时 间 改 进 代码 的 结构 和 设计 ， 我 不 敢 苟 同 。 没 什么 能 比 糟 糕 的 代码 
给 开发 项 目 带 来 更 深远 和 长 期 的 损害 了 。 进 度 可 以 重 订 ， 需 求 可 以 重新 定义 ， 团 队 动 态 可 以 
修正 。 但 糟 糙 的 代码 只 是 一 直 腐 败 发 酵 ， 无 情 地 拖 着 团队 的 后 腿 。 我 无 数 次 看 到 开发 团队 中 
跟前 行 ， 只 因为 他 们 匆匆 摘出 一 片 代码 沼泽 ， 从 此 之 后 命运 再 也 不 受 目 己 控 制 。 

当然 ， 糟 糕 的 代码 可 以 清理 。 不 过 成 本 高 昂 。 随 着 代码 腐败 下 去 ， 模 块 之 间 互 相 渗透 ， 
出 现 大 量 隐藏 纠结 的 依赖 关系 。 找 到 和 破除 陈旧 的 依赖 关系 又 费时 间 叉 费劲 。 为 一 方面 ， 保 
持 代 码 整 洁 却 相对 容易 。 早 晨 在 模块 中 制造 出 一 堆 混 乱 ， 下 午 就 能 轻易 清理 掉 。 更 好 的 情况 
是 ，5 分 钟 之 前 制造 出 混乱 ， 马 上 就 能 很 容易 地 清理 掉 。 l 

所 以 ， 解 决 之 道 就 是 保持 代码 持续 整洁 和 简单 。 永 不 让 腐 坏 有 机 会 开始 。 
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JUnit 是 最 有 名 的 Java 框架 之 一 。 
雅 。 但 它 的 代码 是 怎样 的 呢 ? 本章 将 研判 来 自 JUnit 框架 的 一 个 代码 例子 。 


像 别 的 框架 一 样 ， 它 概念 简单 ， 定 义 精确 ， 实 现 优 
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15.1 JUnit 框架 


JUnit 有 很 多 位 作者 ， 但 它 始 于 Kent Beck 和 Eric Gamma 一 次 去 亚特兰大 的 飞行 旅程 。 
Kent 想 学 Java, M Eric 则 打算 学 习 Kent 的 Smalltalk 测试 框架 。“ 对 于 两 个 身 处 狭窄 空间 的 
奇 客 ， 还 有 什么 会 比 拿 出 笔记 本 电脑 开始 编码 来 得 更 自然 呢 ? ”经 过 3 小 时 高 海拔 工作 ， 他 
们 写 出 了 JUnit 的 基础 代码 。 | | 

我 们 要 查看 的 模块 ， 是 用 来 帮忙 鉴别 字符 串 比 较 错 误 的 一 段 聪明 代码 。 该 模块 被 命名 为 
ComparisonCompactor。 对 于 两 个 不 同 的 字符 串 ， 例 如 ABCDE 和 ABXDE， 它 将 用 形 如 
<...B[X]D...> 的 字符 串 来 曝露 两 者 的 不 同 之 处 。 

我 可 以 做 进一步 解释 ， 但 测试 用 例会 更 有 说 服 力 。 看 看 代码 清单 15-1， 你 将 深入 了 解 到 
该 模块 满足 的 需求 。 边 看 代码 ， 边 研究 该 测试 的 结构 。 它 们 能 变 得 更 简洁 或 更 明确 吗 ? 


代码 清单 15-1 ComparisonCompactorTest.java 


package junit.tests.framework; 


import junit.framework.ComparisonCompactor; 
import junit.framework.TestCase; 


public class ComparisonCompactorTest extends TestCase { 


public void testMessage() { 
String failure- new ComparisonCompactor(0, "b", "c").compact ("a"); 
assertTrue("a expected:«[b]? but was:<[c]>".equals (failure) ); 


public void testStartSame() { 
String failure= new ComparisonCompactor(1, "ba", "bc").compact (null); 
assertEquals ("expected:<b[a]> but was:<b[c]>", failure); 

) 


public void testEndSame() { 
String failures new ComparisonCompactor(1, "ab", "cb").compact (null); 
assertEquals ("expected:«[a]b» but was:<[c]b>", failure); 

p 


public void testSame() { 
String failure- new ComparisonCompactor(1, "ab", "ab").compact (null); 
assertEquals ("expected:<ab> but was:<ab>", failure); 

| 


public void testNoContextStartAndEndSame() { 
String failure= new ComparisonCompactor(0, "abc", "adc").compact (null); 


! 原 注 ; JUnit Pocket Guide, Kent Beck, O'Reilly, 2004, P43. 
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assertEquals ("expected:<...[b]...> but was:<...[d]...>", failure); 
) 


public void testStartAndEndContext() | 
String failure= new ComparisonCompactor(1, "abc", "adc").compact (null); 
assertEquals ("expected:<a[b]c> but was:<a[d]c>", failure); 


} 


public void testStartAndEndContextWithEllipses() { 
String failure= 
new ComparisonCompactor(1, "abcde", "abfde") .compact (null); 
assertEquals ("expected:<...b[c]d...> but was:«...b[f]d...»", failure); 
) 


public void testComparisonErrorStartSameComplete() { 
String failure- new ComparisonCompactor(2, "ab", "apc").compact (null); 
assertEquals ("expected:<ab[]> but was:<ab[c]>", failure); 

} | 


public void testComparisonErrorEndSameComplete() ( 
String failure= new ComparisonCompactor(0, "bc", "abc").compact (null); 
assertEquals ("expected:<[]...> but was:<[a]...>", failure); 


) 


public void testComparisonErrorEndSameCompleteContext() { 
= String failure- new ComparisonCompactor(2, "bc", "abc").compact (null); 
assertEquals ("expected:<[]bc> but was:<[a]bc>", failure); 


} 


public void testComparisonErrorOverlapingMatches() { 
String failure- new ComparisonCompactor(0, "abc", "abbc").compact (null); 
assertEquals ("expected:<...[]...> but was:«...[b]...»", failure); 


) 


public void testComparisonErrorOverlapingMatchesContext() { 
String failure- new ComparisonCompactor(2, "abc", "abbc").compact (null); 
assertEquals ("expected:<ab[]c> but was:<ab[b]c>", failure); 


} / 


public void testComparisonErrorOverlapingMatches2() | 
String failure- new ComparisonCompactor(0, "abcdde", 
"abcde") .compact (null); 
assertEquals ("expected:<...[d]...> but was:«...[]...»", failure); 


) 


public void testComparisonErrorOverlapingMatches2Context() { 
String failure- 

new ComparisonCompactor(2, "abcdde", "abcde") .compact (null); 
assertEquals ("expected:<...cd[dJe> but was:«...cd[]e»", failure); 


) 


public vóid testComparisonErrorWithActualNull() { 
String failure- new ComparisonCompactor(0, "a", null).compact (null); 
assertEquals ("expected:<a> but was:<null>", failure); 
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public void testComparisonErrorWithActualNullContext() { 
String failure- new ComparisonCompactor(2, "a", null). EES e 
assertEquals ("expected:<a> but was:<null>", failure); 

) 


public void testComparisonErrorWithExpectedNull() { 
String failure= new ComparisonCompactor(0, null, "a").compact (null); 
assertEquals ("expected:<null> but was:<a>", failure); 


) 


public void testComparisonErrorWithExpectedNullContext() { 
String failure- new ComparisonCompactor(2, null, "a").compact (null); 
assertEquals ("expected:<null> but was:<a>", failure); 

} , 


public void testBug609972() ( 
String failure- new ComparisonCompactor(10, "S&P500", "0").compact (null); 
assertEquals ("expected:<[S&P50]0> but was:«[]0»", failure); 
|] 
) 
我 对 用 到 这 些 测试 的 ComparisonCompactor #47 T REA 552) Pr. TSH 1009928 T. 
每 行 代码 、 每 个 让 语句 和 for 循环 都 被 测试 执行 了 。 于 是 我 对 代码 的 工作 能 力 有 了 极 高 的 信 
心 ， 也 对 代码 作者 们 的 技艺 产生 了 极 高 的 尊敬 。 
ComparisonCompactor 的 代码 如 代码 清单 15-2 所 示 。 


代码 清单 15-2 E java (原始 版 本 ) 


package junit.framework; 
public class ComparisonCompactor { 


private static final String ELLIPSIS = "..."; 
private static final String DELTA END = "]"; 
private static final String DELTA START = "["; 


private int fContextLength; 
private String fExpected; 
private String fActual; 
private int fPrefix; 
private int fSuffix; 


public ComparisonCompactor(int contextLength, 
String expected, 
String actual) { 
fContextLength = contextLength; 
fExpected = expected; 
fActual = actual; 
) 


public String compact (String message) { 
if (fExpected == null || fActual == null || areStringsEqual()) 
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return Assert.format(message, fExpected, fActual); 


findCommonPrefix(); 

findCommonSuffix(); 

String expected = compactString(fExpected); 
String actual = compactString(fActual) ; 

return Assert.format(message, expected, actual); 


} 


private String compactString(String source) { 
. String result = DELTA START + 
source.substring(fPrefix, source.length() - 
: fSuffix + 1) + DELTA END; 
if (fPrefix > 0) 
result = computeCommonPrefix() + result; 
if (fSuffix » 0) 
result = result + computeCommonSuffix (); 
return result; 


) 


private void findCommonPrefix() { 
fPrefix = 0; 
int end = Math.min(fExpected.length(), fActual.length()); 
for (; fPrefix < end; fPrefixt+) { 
if (fExpected.charAt(fPrefix) != fActual.charAt(fPrefix)) 
break; 
) 
) 


private void findCommonSuffix() { 
int expectedSuffix = fExpected.length() - 1; 


int actualSuffix = fActual.length() - 1; 
for (; 
actualSuffix >= fPrefix && expectedSuffix >= fPrefix; 
actualSuffix--, expectedSuffix--) { 
if (fExpected.charAt(expectedSuffix) != fActual.charAt (actualSuffix)) 
break; 


) j 
fSuffix = fExpected.length() - expectedSuffix; 
) 


private String computeCommonPrefix() { 
return (fPrefix > fContextLength ? ELLIPSIS : "") + 
fExpected.substring(Math.max(0, fPrefix - fContextLength), 
fPrefix); 


) 


private String computeCommonSuffix() { 
int end = Math.min(fExpected.length() - fSuffix + 1 + fContextLength, 
fExpected.length()); 
return fExpected.substring(fExpected.length() - fSuffix * 1, end) * 
(fExpected.length() - fSuffix + 1 < fExpected.length() - 
fContextLength ? ELLIPSIS : ""); 
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private boolean areStringsEqual() { 
return fExpected.equals(fActual); 


) 
) 


你 可 能 会 对 这 个 模块 有 所 抱怨 。 里 面 有 些 长 表达 式 ， 有 些 奇 怪 的 +1 操作 ， 如 此 等 等 。 不 
过 ， 总 的 来 说 ， 这 个 模块 很 不 错 。 毕 竟 它 原本 可 能 被 写成 如 代码 清单 15-3 中 的 样子 。 


代码 清单 15-3 ComparisonCompator.java 背离 版 本 ) 


package junit.framework; 





public class ComparisonCompactor ( 
private int ctxt; 
private String s1; 
private String s2; 
private int pfx; 
private int sfx; 


public ComparisonCompactor (int ctxt, String sl, String s2) { 
this.ctxt = ctxt; 
this.sl = s1; 
this.s2 s2; 

} 


public String compact (String msg) { 
if (sl == null || s2 == null || sl.equals(s2)) 
return Assert.format (msg, sl, s2); 
pfx = 0; 


for (; pfx < Math.min(sl.length(), s2.length()); pfx+t+) ( 
if (sl.charAt(pfx) != s2.charAt(pfx)) 


break; 
) 
int Sfxl = sl.length() - 1; 
int sfx2 = s2.length() - 1; 


for (; Sfx2 >= pfx && sfxl >= pfx; sfx2--, sfxl--) { 
if (sl.charAt(sfxl) != s2.charAt(sfx2)) 
break; 
) 
sfx = sl.length() - sfxl; 
String cmpl = compactString(s1l); 
String cmp2 = compactString(s2); 
return Assert.format (msg, cmpl, cmp2); 


) 


private String compactString(String s) { 
String result - 
"[" + s.substring(pfx, s.length() - sfx + 1) + "J"; 
if (pfx » 0) 
result = (pfx > ctxt ? "..." ; "") + 
sl.substring(Math.max(0, pfx - ctxt), pfx) + result; 
if (sfx > 0) { 
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int end = Math.min(sl.length() ~ sfx + 1 + ctxt, sl.length()); 
result = result + (sl.substring(sl.length() - sfx + 1, end) + 
(sl.length() - sfx + 1 < sl.length() -~ ctxt ? ",.." ; "")); 
| 
return result; 
) | | 
即便 作者 们 把 这 个 模块 写 得 已 经 很 棒 ， 但 童子 军 军 规 却 告诉 我 们 ， 离 时 要 比 来 时 整洁 。 


所 以 ， 我 们 怎样 才能 改进 代码 清单 15-2 中 的 原始 代码 呢 ? 
我 首先 看 到 的 是 成 员 变量 的 f 前 绷 [N6]。 在 现今 的 运行 环境 中 ， 这 类 范围 性 编码 纯 属 多 


余 。 所 以 ， 先 删除 所 有 的 f 前 组 。 


private int contextLength; 
private String expected; 
private String actual; 
private int prefix; 
private int suffix; 


下 一 步 ， 在 compact 函数 开始 处 ， 有 一 个 未 封装 的 条 件 判断 [G28]。 


public String compact (String message) { 
if (expected == null || actual == null || areStringsEqual () ) 
return Assert.format(message, expected, actual); 


findCommonPrefix(); 

findCommonSuffix(); 

String expected = compactString(this.expected); 
String actual = compactString(this.actual); 
return Assert.format(message, expected, actual); 


} | 
这 个 条 件 判 断 应 当 封装 起 来 ， 从 而 更 清晰 地 表达 代码 的 意图 。 我 们 拆 解 出 一 个 方法 ， 解 
释 这 个 条 件 判断 。 


public String compact (String message) | 
if (shouldNotCompact () ) 
return Assert.format(message, expected, actual); 


findCommonPrefix(); 

findCommonSuffix(); 

String expected = compactString(this.expected) ; 
String actual = compactString(this.actual) ; 
return Assert.format (message, expected, actual); 


) 


private boolean shouldNotCompact() { 
return expected == null || actual == null || areStringsEqual () ; 


) 


' RE: 见 前 文 有 关 章 节 。 
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我 也 不 太 喜 欢 compact 函数 中 的 this.expected 和 this.actual 符号 ,这 个 是 我 们 把 fExpected 
DU expected 时 发 生 的。 为 什么 函数 中 的 变量 会 与 成 员 变量 同名 呢 ? 它们 不 是 该 表示 其 他 意 
思 吗 IN4]? 我 们 应 该 区 分 这 些 名 称 。 


String compactExpected = compactString (expected); 
String compactActual = compactString (actual); 


否定 式 稍微 比 肯 定式 难 理解 一 些 [G29]。 我 们 把 站 语句 放 到 上 头 ， 调 转 条 件 判 断 。 


public String compact (String message) { 
if (canBeCompacted()) { 
findCommonPrefix(); 
findCommonSuffix(); 
String compactExpected = compactString (expected); 
String compactActual = compactString (actual); 
return Assert.format(message, compactExpected, compactActual); 
else ( 
return Assert.format(message, expected, actual); 
) 
) 


e 


private boolean canBeCompacted() { 
return expected != null && actual != null && !areStringsEqual(); 


) 


函数 名 很 奇怪 IN7]。 尽 管 它 的 确 会 压缩 字符 串 ， 但 如 果 canBeCompact 为 false， 它 实际 
上 就 不 会 压缩 字符 串 。 用 compact 来 命名 ， 隐 藏 了 错误 检查 的 副作用 。 注 意 ， 该 函数 返回 一 
条 格式 化 后 的 消息 , 而 不 仅仅 只 是 压缩 后 的 字符 串 。 所 以 ,函数 名 其 实 应 该 是 formatCompacted 
Comparison。 在 用 以 下 参数 调用 时 ， 读 起 来 会 好 很 多 ; 


public String formatCompactedComparison(String message) { 


两 个 字符 串 是 在 让 语句 体 中 压缩 的 。 我 们 应 当 拆 分 出 一 个 名 为 sonnei peeled Anat 
的 方法 。 然 而 , 我 们 希望 formatCompactComparison 函数 完成 所 有 的 格式 化 工作 。 Tfi compact... 
函数 除了 压缩 之 外 什么 都 不 做 [G30]。 所 以 ， 做 如 下 拆 分 : 


private String compactExpected; 
private String compactActual; 


public String formatCompactedComparison(String message) { 
if (canBeCompacted()) ( 
compactExpectedAndActual () ; 
return Assert.format (message, compactExpected, compactActual) ; 
} else { 
return Assert.format (message, expected, actual); 
} 
} 


private void compactExpectedAndActual () { 
findCommonPrefix(); 
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findCommonSuffix(); 
compactExpected = compactString (expected); 
compactActual = compactString (actual); 


) 


注意 ， 这 要 求 我 们 向 成 员 变 量 举 荐 compactExpected 和 compactActual。 我 不 喜欢 新 函数 
最 后 两 行 返回 变量 的 方式 , 但 前 两 个 可 不 是 这 样 。 它 们 没 采用 一 以 贯 之 的 约定 [G11]。 我 们 应 
该 修改 findCommonPrefix 和 findCommonSuffix, 返回 前 级 和 后 缀 值 。 | 


private void compactExpectedAndActual() { 
prefixIndex - findCommonPrefix(); 
suffixIndex - findCommonSuffix(); 
compactExpected = compactString (expected); 
compactActual = compactString (actual); 


] 


private int findCommonPrefix() ( 
int prefixIndex - 0; 
int end = Math.min(expected.length(), actual.length()); 
for (; prefixIndex < end; prefixIndext++) { 
if (expected.charAt (prefixIndex) != actual.charAt (prefixIndex) ) 
break; 
} 
return prefixIndex; 


) 


private int findCommonSuffix() ( 
int expectedSuffix = expected.length() - 1; 
int actualSuffix = actual.length() - 1; 
for (; actualSuffix >= prefixIndex && expectedSuffix >= prefixIndex; 


actualSuffix--, expectedSuffix--) { 
if (expected.charAt(expectedSuffix) != actual.charAt (actualSuffix) ) 
break; 
) 
return expected.length() - expectedSuffix; 


} 


我 们 还 应 该 修改 成 员 变 量 的 名 称 ， 使 之 更 准确 一 点 [N1]; 毕竟 它们 都 是 索引 。 

仔细 检查 findCommonSuffix， 其 中 藏 了 个 时 序 性 耦合 [G31];， 它 依赖 于 prefixIndex 是 由 
findCommonSuffix 计算 得 来 的 事实 。 如 果 这 两 个 方法 不 是 按 这 样 的 顺序 调用 ， 调 试 就 会 变 得 
困难 。 为 了 骏 露 这 个 时 序 性 耦合 ， 我 们 将 prefixIndex 做 成 find 的 参数 。 | 


private void compactExpectedAndActual() { 
prefixIndex = findCommonPrefix(); 
suffixIndex = findCommonSuffix(prefixIndex); 
compactExpected = compactString (expected); 
compactActual. = compactString (actual); 

) 


private int findCommonSuffix(int prefixIndex) { 
int expectedSuffix = expected.length() - 1; 
int actualSuffix = actual.length() - 1; 
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for (; actualSuffix >= prefixIndex && expectedSuffix >= prefixIndex; 
actualSuffix--, expectedSuffix--) { 
if (expected.charAt(expectedSuffix) != actual.charAt(actualSuffix)) 
break; 
) : 
return expected.length() - expectedSuffix; 
) 


我 对 这 样 的 方式 不 太 满意 。 传 递 prefixIndex 参数 有 些 随意 [G32]。 它 成 功 维持 了 执行 次 
序 ， 但 对 于 解释 排序 的 需要 却 毫 无 作用 。 其 他 程序 员 可 能 会 抹杀 我 们 刚 完成 的 工作 ， 因 为 并 
没有 迹象 说 明 该 参数 确 属 必要 。 还 是 采取 别 的 做 法 吧 。 


private void compactExpectedAndActual() { 
findCommonPrefixAndSuffix(); 
compactExpected = compactString(expected); 
compactActual = compactString (actual); 

) 


private void findCommonPrefixAndSuffix() | 
findCommonPrefix(); 
int expectedSuffix = expected.length() - 1; 
int actualSuffix = actual.length() - 1; 
for (; 
actualSuffix >= prefixIndex && expectedSuffix >= prefixIndex; 
actualSuffix--, expectedSuffix-- 
) ( 
if (expected.charAt(expectedSuffix) != actual.charAt (actualSuffix) ) 
break; 
) 
suffixIndex = expected.length() - expectedSuffix; 
) 


private void findCommonPrefix() | 
prefixIndex = 0; 
int end = Math.min(expected.length(), actual.length()); 
for (; prefixIndex < end; prefixIndex**) 
if (expected.charAt(prefixIndex) != actual.charAt (prefixIndex)) 
break; 


) 


我 们 恢复 findCommonPreffix 和 findCommonSuffix 的 原样 ， 把 findCommonSuffix 的 名 称 改 为 
findCommonPrefxAndSuffx， 让 它 在 执行 其 他 操作 之 前 ， 先 调用 findCommonPrefix。 这 样 一 来 ， 
就 以 一 种 相 比 前 种 手段 更 为 有 效 的 方式 建立 了 两 个 函数 之 间 的 时 序 关 系 。 


private void findCommonPrefixAndSuffix() I 
findCommonPrefix(); 
int suffixLength = 1; 
for (; !suffixOverlapsPrefix(suffixLength); suffixLength++) { 
if (charFromEnd(expected, suffixLength) !- 
charFromEnd(actual, suffixLength)) 
break; 
) 
suffixIndex = suffixLength; 


15.1 JUnit 框架 245 


) 


private char charFromEnd(String s, int i) { 
return s.charAt (s.length()-i); 
) 


private boolean suffixOverlapsPrefix(int suffixLength) ( 
return actual.length() - suffixLength < prefixLength || 
expected.length() ~ suffixLength < prefixLength; 
) 


这 样 就 好 多 了 。 它 暴露 出 suffixIndex 其 实 是 后 弧 的 长 度 ， 而 且 名 字 没 取 好 。 对 于 prefix 
也 是 如 此 。 虽 然 在 那样 一 种 情形 下 index 和 length 是 同 义 的 ， 但 使 用 length 一 词 却 更 有 一 贯 
性 。 问 题 在 于 ，suffixIndex 变量 并 不 从 0 开始 ， 它 从 1 开始 ， 所 以 并 非 真正 的 长 度 。 这 也 是 
computeCommonSuffix 中 那些 +1 存在 的 原因 [G33]。 来 修正 它们 吧 。 结 果 就 是 代码 清单 15-4。 


代码 清单 15-4 ComparisonCompactorjava (过 渡 版 本 ) - 


public class ComparisonCompactor { 
private int suffixLength; 


private void findCommonPrefixAndSuffix() ( 
findCommonPrefix(); 
suffixLength - 0; 
for (; !suffixOverlapsPrefix(suffixLength); suffixLength**) ( 
if (charFromEnd(expected, suffixLength) != 
charFromEnd(actual, suffixLength)) 
break; 
) 
) 


private char charFromEnd(String s, int i) { 
return s.charAt(s.length() - i - 1); 
) 
private boolean suffixOverlapsPrefix(int suffixLength) ( 
return actual.length() - suffixLength <= prefixLength || 
|J expected.length() - suffixLength <= prefixLength; 


) 


private String compactString(String source) ( 

String result - 
DELTA START * 
source.substring(prefixLength, source.length() - suffixLength) + 
DELTA END; 

if (prefixLength » 0) 
result - computeCommonPrefix() * result; 

if (suffixLength > 0) 
result = result + computeCommonSuffix(); 

return result; 


) 
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private String computeCommonSuffix() { 
int end = Math.min(expected.length() - suffixLength + 
contextLength, expected.length() 
) ; | | 
return 
expected.substring(expected.length() - suffixLength, end) + 
(expected.length() - suffixLength « 
expected.length() - SES? ? 
ELLIPSIS : ""); 
} 


我 们 用 charFromEnd 中 的 那个 -1 替代 了 computeCommonSuffix 中 的 一 堆 +1, 前 者 更 为 合 
情 合理 ，suffixOverlapsPrefix 中 的 两 个 “<=” 操 作 符 也 同 理 。 AR TAE suffixIndex 


和 suffixLength 的 名 称 ， 极 大 地 提升 了 代码 的 可 读 性 。 
不 过 还 有 一 个 问题 。 在 消灭 那些 +1 时 ， 我 注意 到 compactString 中 的 以 下 代码 : 


if (suffixLength > 0) 


看 看 代码 清单 15-4 中 的 这 行 代码 。 因 为 suffixLength 现在 要 比 原本 少 1， 我 应 该 把 “>” 
操作 符 改 为 “>=” 操 作 符 。 那 本 无 道理 ， 不 过 现在 却 有 意义 ! 这 表示 这 么 做 没 道理 ， 而 且 可 
REET ERI. OR, HABER. MZ PRN SS, if 语句 现在 会 放置 添加 
长 度 为 零 的 后 经。 在 作出 修改 之 前 ， 直 语句 没有 作用 ， 因 为 suffixIndex 永 不 会 小 于 1. 

这 说 明 compactString FHA if BARA Aa! 看 起 来 它们 都 该 删除 。 所 以 , 我 们 将 其 
注释 掉 ， 运 行 测试 。 测 试 通过 了 ! 那 就 重新 构 染 compactString， 删 除 没 用 的 证 语句 ， 将 函数 
改 得 更 加 简洁 [G9]。 


private String compactString(String source) { 
return 
computeCommonPrefix() + 
DELTA_START + 
source.substring(prefixLength, source.length() - suffixLength) + 
DELTA_END + ) 
computeCommonSuffix(); 


) 
这 样 就 好 多 了 ! 现在 我 们 看 到 ，compactString 函数 只 是 把 片段 组 合 起 来 。 我 们 甚至 可 以 
它 更 清晰 。 有 许多 细微 的 整理 工作 可 做 。 与 其 拖 着 你 遍历 剩 下 的 那些 修改 ， 我 更 愿意 直接 
展示 代码 清单 15-5 中 的 结果 。 


代码 清单 15-5. ComparisonCompactor.java (最终 版 ) 


package junit.framework; 
public class ComparisonCompactor { 
private static final String ELLIPSIS - "..."; 


private static final String DELTA END = "]"; 
private static final String DELTA START - "["; 
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private int contextLength; 
private String expected; 
private String actual; 
private int prefixLength; 
private int suffixLength; 


public ComparisonCompactor ( 
int contextLength, String expected, String actual 
) { 
this.contextLength = contextLength; 
this.expected = expected; 
this.actual = actual; 


} 


public String formatCompactedComparison(String message) { 
String compactExpected = expected; 
String compactActual = actual; 
if (shouldBeCompacted()) { 
findCommonPrefixAndSuf fix (); 
compactExpected = compact (expected) ; 
compactActual = compact (actual); 
} 
return Assert.format(message, compactExpected, compactActual) ; 
} 


private boolean shouldBeCompacted() { 
return !shouldNotBeCompacted(); 
} 


private boolean shouldNotBeCompacted() { 
return expected == null || 
actual == null || 
expected.equals (actual) ; 


} 


private void findCommonPrefixAndSuffix() { 
findCommonPrefix(); 
suffixLength = 0; 
for (; !suffixOverlapsPrefix(); suffixLength**) { 
if (charFromEnd(expected, suffixLength) !- 
charFromEnd(actual, suffixLength) 
) 
break; 
) 
) 


private char charFromEnd(String s, int i) { 
return s.charAt(s.length() - i - 1); 
) 


private boolean suffixOverlapsPrefix() .{ 
return actual.length() - suffixLength <= prefixLength || 
expected.length() - suffixLength «- prefixLength; 
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private void findCommonPrefix() { 
prefixLength = 0; 
int end = Math .min (expected. length(), actual.length()); 
for (; prefixLength < end; prefixLengtht*) 
if (expected.charAt(prefixLength) != actual.charAt (prefixLengthl) 
break; 


} 


private String compact (String s) { 
return new StringBuilder () 
append (startingEllipsis()) 
.append (startingContext () ) 
. append (DELTA START) 
.append (delta (s)) ` | 1 
. append (DELTA_END) 
.append (endingContext ()) 
.append (endingEllipsis()) 
.toString(); 

) 


private String startingEllipsis() { 
return prefixLength > contextLength ? ELLIPSIS : ""; 


} 


private String startingContext() { 
int contextStart = Math.max(0, prefixLength - contextLength) ; 
int contextEnd = prefixLength; 
return expected.substring(contextStart, contextEnd) ; 


) 


private String delta(String s) { 
int deltaStart = prefixLength; 
int deltaEnd = s.length() - suffixLength; 
return s.substring(deltaStart, deltaEnd); 


) 


private String endingContext() { 
int contextStart = expected.length() - Ssuttixtengthi 
int contextEnd - 
Math.min(contextStart * contextLength, expected.length()); 
return expected.substring(contextStart, contextEnd) ; 


} 


private String endingEllipsis() { 
return (suffixLength > contextLength ? ELLIPSIS : ""); 


} 
} 


这 的 确 很 漂亮 。 模块 分 解 成 了 一 组 分 析 函 数 和 一 组 合成 函数 。 它 们 以 一 种 拓扑 方式 排序 ， 
每 个 函数 的 定义 都 正好 在 其 被 调用 的 位 置 后 面 。 所 有 的 分 析 函 数 都 先 出 现 ， 而 所 有 的 合成 函 
数 都 最 后 出 现 。 
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仔细 阅读 ， 你 会 发 现 我 推翻 了 在 本 章 较 前 位 置 做 出 的 几 个 决定 。 例 如 ， 我 将 几 个 分 解 出 
来 的 方法 重新 内 联 为 formatCompactComparison, 我 修改 了 souldNotBeCompacted 表达 式 的 意 
思 。 这 种 做 法 很 常见 。 重 构 常 会 导致 男 一 次 推翻 此 次 重 构 的 重 构 。 重 构 是 一 种 不 停 试 错 的 大 
代 过 程 ， 不 可 避免 地 集中 于 我 们 认为 是 专业 人 员 该 做 的 事 。 


15.2 小 结 


如 此 我 们 遵循 了 童子 军 军 规 。 模 块 比 我 们 发 现 它 时 更 整洁 了 。 不 是 说 它 原本 不 整洁 ，。 
作者 们 做 了 卓越 的 工作 。 但 模块 都 能 再 改进 , 我 们 每 个 人 也 有 责任 把 模块 改进 得 比 发 现时 . 
更 整洁 。 | 
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如 果 你 访问 http://www:jfree.org/jcommon/index.php， 就 能 找到 JCommon 类 库 。 深 入 该 类 
库 ， 其 中 有 个 名 为 orgjfree.date 的 程序 包 。 在 该 程序 包 中 ， 有 个 名 为 SerialDate 的 类 。 我 们 
即将 剖析 这 个 类 。， 

SerialDate 的 作者 是 David Gilbert。David 显然 是 位 经 验 丰 富 、 能 力 足 够 的 程序 员 。 如 我 
们 将 看 到 的 ， 他 在 代码 中 展示 了 极 高 的 专业 性 和 原则 性 。 无 论 怎么 说 ， 这 都 是 “好 代码 ”。 而 
我 将 把 它 撕 成 碎片 。 | | 
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这 并 非 恶意 的 行为 。 我 也 不 认为 自己 比 戴 维 强 许多 ， 有 权 对 他 的 代码 说 三 道 四 。 其 实 ， 

如 果 你 看 过 我 的 代码 ， 我 敢 说 你 也 会 发 现 好 些 该 埋怨 的 东西 。 

不 ， 这 也 并 非 傲慢 无 礼 的 行为 。 我 所 要 做 的 ， 只 是 一 种 专业 眼光 的 检视 ， 不 多 也 不 少 。 
那 是 我 们 都 该 坦然 接受 的 做 法 。 那 是 我 们 应 该 欢迎 别人 对 上 自己 做 的 事 。 只 有 通过 这 样 的 批评 ， 
我 们 才能 学 到 东西 。 医 生 就 是 这 样 做 的 。 飞 行 员 就 是 这 样 做 的 。 律 师 就 是 这 样 做 的 。 我 们 程 
序 员 也 需要 学 习 如 何 这 样 做 。 

多 说 一 句 关于 David Gilbert 的 事 : David 不 止 是 位 优秀 的 程序 员 。 戴 维 有 着 将 代码 免费 呈 
献 给 社区 的 勇气 和 好 心 。 他 公开 代码 ， 让 所 有 人 都 能 看 到 ， 邀 请 大 众 使 用 并 审查 。 做 得 真 好 ! 

SerialDate ( 见 代码 清单 B-1) 是 一 个 用 Java 呈现 一 个 日 期 的 类 。 为 什么 在 Java 已 经 有 
java.util.Date 和 java.util.Calendar 的 时 候 ， 还 需要 一 个 呈现 日 期 的 类 呢 ? 作者 编写 这 个 类 ， 是 
为 了 响应 我 自己 也 常 感到 的 痛苦 。 在 开放 的 Javadoc (38 67 行 ) 中 ， 他 很 好 地 解释 了 原因 。 
我 们 可 以 质疑 他 的 初衷 ， 但 我 的 确 有 处 理 这 个 问题 的 需要 ， 而 且 我 也 欢迎 有 个 关心 日 期 其 于 
时 间 的 类 存在 。 


16.1 首先 ， 让 它 能 工作 


在 一 个 名 为 SerialDateTests 的 类 ( 见 代 码 清单 B-2) P, 有 一 些 单元 测试 。 测试 都 通过 了 。 
不 幸 的 是 ， 快 览 一 遍 测 试 ， 发 现 它 们 并 没有 测试 所 有 东西 [T1]。 例 如 ， 用 “查找 使 用 ”搜索 
方法 MonthCodeToQuarter ($ 334 行 )， 会 发 现 没 有 被 用 过 [F4]。 因 此 ， 单 元 测试 并 没有 测试 
这 个 方法 。 

所 以 , 我 用 Clover 来 检查 单元 测试 覆盖 了 哪些 代码 。 Clover 报告 说 , 在 SerialDate 的 185 
个 可 执行 语句 中 ， 单 元 测试 只 执行 了 91 个 ( 约 50%) [T2]。 禾 盖 图 看 起 来 像 是 一 床 满 是 补丁 
的 棉 被 ， 整 个 类 上 布 满 大 块 的 未 执行 代码 。 

我 的 目标 是 完整 地 理解 和 重 构 这 个 类 。 没 有 好 得 多 的 测试 覆盖 率 ， 做 不 到 这 个 。 所 以 ， 
我 完全 重 起 炉灶 编写 了 自己 的 单元 测试 〈 见 代码 清单 B-4)。 

在 阅读 这 些 测试 时 ， 你 可 以 看 到 ， 其 中 许多 注释 掉 了。 这些 测 试 不 能 通过 。 它 们 代表 了 
我 以 为 SerialDate 应 该 有 的 行为 。 在 我 重 构 SerialDate 时 ， 也 将 让 这 些 测试 通过 。 

即便 有 些 测试 被 注释 掉 , Clover 还 是 报告 新 的 单元 测试 执行 了 185 个 可 执行 语句 中 的 170 
个 (92%)。 这 样 就 好 多 了 ， 而 且 我 想 我 们 可 以 把 这 个 数字 提高 些 。 

前 几 个 注释 掉 的 测试 (第 23—63 T) 是 我 一 厢 情 愿 。 程 序 并 没有 设计 为 通过 这 些 测 
试 ， 但 对 我 来 说 它们 代表 的 行为 显而易见 [G2]。 我 不 太 确定 testWeekdayCodeToString 7j 
法 为 何 要 写成 那样 ， 不 过 既然 它 已 经 在 那儿 ， 显 然 不 该 是 区 分 大 小 写 的 。 编 写 这 些 测试 
是 区 区 小 事 [T3]， 通 过 测试 更 加 容易 。 A 修改 了 第 259 行 和 和 263 行 ， 就 能 使 用 


equalsIgnoreCase 了 。 
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我 注释 掉 了 第 32 45 行 的 测试 ， 因 为 我 不 太 明 确 是 否 应 该 支持 tues 和 thurs 
缩写 。 

第 153 行 和 154 行 的 测试 不 能 通过 。 显 然 ， 它 们 本 该 通过 [G2]。 我 们 可 以 轻易 地 修正 ， 
只 要 对 stringToMonthCode 作出 以 下 修改 就 行 ， 对 于 第 163 行 和 213 行 的 测试 也 一 样 。 


457 .if ((result < 1) || (result > 12)) { 
result = -1; 
458 for (int i = 0; i < monthNames.length; i++) ( 
459 if (s.equalsIgnoreCase(shortMonthNames[i])) ( 
460 result = i + 1; | 
461 break; 
462 } 
. 463 if (s.equalsIgnoreCase (monthNames[i])) { 
464 | result = i + 1; 
465 break; 
466 } 
467 } 
468 } 


第 318 行 注释 掉 的 测试 暴露 了 getFollowingDayOfWeek 方法 中 的 一 个 缺陷 〈 第 672 112. 
2004 年 12 月 25 日 是 个 周 六 。 下 一 个 周 六 是 2005 4E 1 月 1 日 。 然 而 ， 运 行 测试 时 ， 会 看 到 
getFollowingDayOfWeek 返回 12 月 25 日 之 后 的 周 六 还 是 12 月 25 日 。 显 然 这 不 对 [G3] [T1]。 
我 们 看 到 问题 在 第 685 行 。 那 是 个 典型 的 边界 条 件 错误 [T5]。 应 该 是 这 样 ; 


685 if (baseDOW >= targetWeekday) { 


很 有 意思 , 这 个 函数 是 之 前 一 次 修改 的 结果 。 修 改 记 录 ( 第 43 47) SAR, getPreviousDayOf Week. 
getFollowingDayOfWeek 和 getNearestDayOfWeek 中 的 “缺陷 ”已 被 修正 [T6]。 

测试 getNearestDayOfWeek ($ 705 T) 的 单元 测试 testGetNearestDayOfWeek (第 329 
ÍT) 之 前 的 版 本 不 像 现在 一 样 没有 遗漏 。 我 添加 了 大 量 测试 用 例 ， 因 为 初始 的 测试 用 例 并 没 
有 全 部 通过 [T6]。 碍 看 哪些 测试 用 例 被 注释 掉 ， 你 可 以 看 到 失败 的 模式 ， 这 很 有 局 发。 如 果 
最 近 的 日 期 是 在 未 来 ， 算 法 就 会 失败 。 显 然 存在 某 种 边界 条 件 错误 [T5]。 

Clover 汇报 的 测试 覆盖 模式 也 很 有 趣 [T8]。 第 719 行 根本 没有 执行 ! 这 意味 着 第 718 T. 
的 让 语句 总 是 得 到 false 的 结果 。 没 错 ， 看 一 眼 代码 就 知道 是 这 样 。 变量 adjust 总 是 为 负 ， 所 
以 不 会 大 于 或 等 于 4。 所 以， 算法 错 了 。 

正确 的 算法 如 下 所 示 : 

int delta = targetDOW - base.getDayOfWeek() ; 

int positiveDelta - delta * 7; 

int adjust - positiveDelta $ 7; 

if (adjust » 3) 


adjust -= 7; 
return SerialDate. addDays (adjust, base); 


最 后 ， 只 要 简单 地 抛 出 (EEN 异常 而 不 RÀ S weekInMonthToString 和 
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relativeToString 返回 错误 字符 串 ， 第 417 行 和 429 行 的 测试 也 能 通过 。 
所 有 的 单元 测试 都 通过 了 ， 我 确信 SerialDate SEN 以 工作 。 是 时 候 
让 它 é€ 做 对 » 


16.2 ”让 它 做 对 


我 们 将 从 头 到 尾 遍 历 SerialDate, 同时 加 以 改进 ,尽管 在 本 章 的 讨论 中 你 看 不 到 这 个 过 程 ， 
在 每 次 做 修改 后 ,我 还 是 要 运行 全 部 JCommon 单元 测试 ， 包括 我 为 SerialDate 改进 的 那些 单 
元 测试 。 所 以 ， 后 面 你 看 到 的 所 有 修改 ， 对 于 JCommon 都 是 可 工作 的 。， 

从 第 1 行 开 始 ， 我 看 到 大 量 有 关 许 可 、 版 权 、 作 者 和 修改 历史 的 注释 。 我 明白 ， 的 确 有 
些 法 律 事 宜 要 说 明 ， 所 以 版 权 和 许可 信息 应 该 保留 。 另 外 ， 修 改 历史 是 产生 于 19 世纪 60 年 
代 的 古董 ， 现 今 源 代码 控制 工具 可 以 帮 有 我 们 做 到 这 个 。 应 该 删 掉 修改 历史 [C1]。 

从 第 61 行 开 始 的 导入 列表 应 该 通过 使 用 java.text. HI java.util.*2K 4848» [J1] 

Javadoc 的 HTML 格式 化 工作 (第 67 行 ) 令 我 垦 惧 。 一 个 源 文件 里 面 有 多 种 语言 ， 我 有 
RAR. RIERA 4 种 语言 : Java. SX. Javadoc 和 html[G1]。 有 那么 多 语言 ， 就 很 难 直 
截 了 当 。 例 如 ， 生 成 Javadoc 后 ， 第 71 行 和 72 行 原 本 很 好 的 位 置 就 丢失 了 ， 而 且 谁 起 在 源 
代码 中 看 到 <ul> 和 <li> 这 样 的 东西 呢 ? 更 好 的 策略 可 能 是 用 <pre> 标 签 把 整个 注释 部 分 包围 起 
来 ， 这 样 ， 对 于 源 代 码 的 格式 化 只 会 限于 Javadoc 之 内 '。 

第 86 行 是 类 声明 。 这 个 类 为 何 要 命名 为 SerialDate? Serial 一 词 有 什么 妙 处 吗 ? 是 不 是 
因为 该 类 派生 自 Serializable? 看 来 不 是 这 样 的 。 

别 猜 了 ， 我 知道 为 什么 〈 或 者 我 认为 自己 知道 ) 何以 要 用 Serial 一 词 。 线 索 就 在 位 于 第 
98 行 和 101 行 的 常量 SERIAL LOWER BOUND 和 SERIAL UPPER BOUND。 更 好 的 线索 在 
从 第 830 行 开始 的 注释 中 。 该 类 被 命名 为 SerialDate， 是 因为 它 用 “序列 数 ”(serial number) 
来 实现 ， 该 系列 数 恰好 是 从 1899 年 12 月 30 日 后 的 天 数 。 | 

对 此 我 有 两 个 问题 。 首 先 ， 术 语 “ 序 列 数 ”并 不 真 对 。 可 能 有 点 诡辩 ， 但 其 呈现 方式 却 
更 接近 相对 偏 移 其 于 序列 数 。 术 语 “ 序 列 数 ” 更 多 地 用 于 产品 版 本 标识 ， 而 非 日 期 标识 
没 发 现 这 个 名 称 特别 有 描述 力 [N1]。 更 有 描述 力 的 术语 大 概 是 “顺序 ”(ordinal)。 

第 二 个 问题 更 突出 。 名 称 SerialDate 暗示 了 一 种 实现 。 该 类 是 个 抽象 类 。 没 必要 暗示 任 
{Ay ESE BLY SF. SE BE, 没 理由 隐藏 实现 ! 我 发 现 这 个 名 称 放 在 了 不 正确 的 抽象 层级 上 [N2]。 
以 我 之 见 ， 该 类 的 名 称 应 该 就 是 简单 的 Date。 

ANEW FE, Java 类 库 里 面 有 太 多 叫 Date 的 类 了 ， 所 以 这 大 概 也 不 是 最 好 的 名 称 。 因 为 这 
个 类 是 关于 日 期 而 非 时 间 ， 我 想 将 其 命名 为 Day， 但 这 个 名 字 也 在 多 处 被 滥用 。 最 后 ， 我 选 


' UE: 更 好 的 解决 方案 是 让 Javadoc 不 对 注释 做 格式 化 ， 这 样 注释 在 代码 和 文档 中 就 会 是 一 种 样式 。 
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了 DayDate (EA RED RIT. 
从 现在 起 ， 我 将 使 用 术语 DayDate。 请 记 住 ， 你 读 到 的 代码 清单 ， 还 是 用 的 SerialDate. 
我 理解 为 何 DayDate 继承 自 Comparable 和 Serializable。 不 过 ， 为 什么 它 要 继承 自 
MonthConstants WE? 类 MonthConstants( 见 代码 清单 B-3) 只 是 一 大 堆 定义 了 月 份 的 静态 常量 。 
从 常量 类 继承 是 Java 程序 员 用 的 一 种 老 花招 ,这样 他 们 就 能 避免 形 如 MonthConstants.January 
的 表达 式 ， 不 过 这 是 个 坏 主意 [J2]。MonthConstants H KAZEN 


public abstract class DayDate implements Comparable, 
2 | | Serializable (- 
public static enum Month { | 

JANUARY (1), 

FEBRUARY (2), 

MARCH (3), 

APRIL(4), 

MAY (5), 

JUNE(6), 

JULY (7), 

AUGUST (8), 

SEPTEMBER (9), 

OCTOBER (10), 

NOVEMBER (11), 

DECEMBER (12) ; 


Month(int index) { 
this.index = index; 


} 


public static Month make(int monthIndex) { 
for (Month m : Month.values()) { 
if (m.index == monthIndex) 
return m; 


) | 
throw new IllegalArgumentException("Invalid month index " * monthIndex); 


) l 
public final int index; 


} 


把 MonthConstants 改 成 枚 举 ， 导 致 对 DayDate 类 和 用 到 这 个 类 的 代码 的 一 些 修改 。 我 花 
了 一 个 小 时 来 改 代码 。 不 过 ， 原 来 以 int 为 月 份 类 型 的 函数 ， 现 在 都 用 上 Month 枚 举 元 素 了 。 
这 意味 着 我 们 可 以 去 除 isValidMonthCode 方法 (第 326 行 )， 以 及 monthCodeToQuarter 等 位 
置 的 月 份 代码 错误 检查 (第 356 行 ) 了 [G5]。 
下 一 步 ， 我 们 看 到 第 91 行 ，serialVersionUID。 该 变量 用 于 控制 序列 号 。 如 果 我 们 修改 了 它 ， 
用 这 个 软件 编写 的 旧版 本 DayDate 都 将 不 再 可 用 ， 而 是 返回 一 个 InvalidClassException 异常 。 如 
果 你 没有 声明 serialVersionUID 变量 ， 则 编译 器 会 日 动 生成 一 个 ， 每 次 修改 模块 时 都 会 得 到 不 一 
样 的 值 。 我 知道 ， 所 有 的 文档 都 建议 手工 控制 这 个 变量 ， 但 对 我 来 说 自动 控制 序列 号 安全 得 多 
[G4]. 我 宁肯 调试 InvalidClassException, 也 不 愿意 见 到 如 果 态 记 修 改 serialVersionUID 引起 的 后 
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续 工作 。 所 以 ， 我 要 删除 这 个 变量 一 至 少 暂 时 这 么 做 1!。 

REME 93 行 的 注释 是 多 余 的 。 这 正 是 谎言 和 误导 信 a 所 以 我 要 干掉 它 
和 它 的 同类 。 

第 97 行 和 100 行 的 注释 有 关 序 列 数 ， 我 之 前 — + ABICI). 它们 描述 的 变量 
是 DayDate 能 够 描述 的 最 早 和 最 后 的 日 期 。 这 可 以 搞 得 更 清楚 些 [N1]。 


public static final int EARLIEST DATE ORDINAL = 2; // 1/1/1900 
public static final int LATEST DATE ORDINAL = 2958465; // 12/31/9999 


我 不 太 清 楚 为 什么 EARLIEST DATE ORDINAL 是 2 而 不 是 0。 在 第 829 行 的 注释 中 有 
个 提示 ,说 明 这 与 用 Microsoft Excel 展示 日 期 的 方式 有 关 。 在 DayDate 的 派生 类 SpredsheetDate 
中 能 看 得 更 深入 〈 见 代码 清单 B-5)。 第 71 行 的 注释 很 好 地 描述 了 这 个 问题 。 

我 的 问题 是 ， 这 看 来 应 该 与 SpreadsheetDate 有 关 ， 与 DayDate 无 关 才 对 。 所 以 ， 
EARLIEST_DATE_ORDINAL 和 LATEST_DATE_ORDINAL 实在 不 该 属于 DayDate， 应 该 移 
到 SpreadSheeDate 中 [G6]。 | 

的 确 ， 搜 索 一 下 代码 就 知道 ， 这 些 变量 值 仅 在 SpreadSheetDate 中 用 到 。DayDate 中 没 用 
到 ，JCommon 框架 的 其 他 类 中 也 没有 用 。 所 以 ， 我 将 把 它们 向 下 移 到 SpreadSheetDate F. 

下 面 两 个 变量 , MINIMUN YEAR SUPPORTED 和 MAXIMUM_YEAR_SUPPORTED (第 
104 行 和 107 行 ) ME, RS, WR DayDate 是 个 没有 提供 实现 铺垫 的 抽象 类 ， 它 就 不 该 
告知 我 们 有 关 最 小 和 最 大 年 份 的 信息 。 同 样 ， 我 很 想 把 这 些 变量 向 下 移 到 SpreadSheetDate 中 
[G6]。 然 而 ， 快 速 查 找 这 些 变量 的 使 用 情况 ， 会 发 现 另 一 个 类 也 在 用 : RelativeDayOfWeekRule 
( 见 代码 清单 B-6)。 在 第 177 行 和 178 行 ，getDate 函数 中 ， 它 们 被 用 来 检查 getDate 的 年 份 
参数 是 否 有 效 。 抽 象 类 的 用 户 需 要 得 知 其 实现 信息 ， 这 是 个 矛盾 。 | 

我 们 要 做 的 是 既 提 供 信 息 ， 又 不 污染 DayDate。 通 常 ， 我 们 会 从 派生 类 实体 中 获取 实现 信 
” 息 。 不 过 ， 并 未 向 getDate 函数 传 入 DayDate 的 实体 ， 反 而 返回 了 这 么 一 个 实体 。 这 意味 着 必 

须 在 某 处 创建 实体 。 第 187 一 205 行 提供 了 线索 。DayDate 实体 是 在 getPreviousDayOfWeek、 
getNearestDayOfWeek 或 getFollowingDayOfWeek 这 三 个 函数 其 中 之 一 里 面 创建 的 。 看 回 
DayDate 代码 清单 , 我们 看 到 ,这 些 函数 (第 638—724 行 ) 全 都 返回 了 由 addDays C28 571 行 ) 
创建 的 日 期 实体 , addDays 调用 CreateInstance (第 808 行 ), 创建 出 一 个 SpreadSheetDate ! [G7]. 

通常 来 说 ， 基 类 不 宜 了 解 其 派生 类 的 情况 。 为 了 修正 这 个 毛病 ， 我 们 应 该 利用 抽象 工厂 
模式 (ABSTRACT FACTORY) )“， 创 建 一 个 DayDateFactory。 该 工厂 将 创建 我 们 所 需要 的 
DayDate 的 实体 ， 并 回答 有 关 实 现 的 问题 ， 例 如 最 大 和 最 小 日 期 之 类 。 





! 原 注 ， 本 章 的 好 几 个 审读 者 都 不 这 么 认为 。 他 们 主张 ， 在 开源 框架 中 ， 手 工控 制 序列 ID 会 比较 好 ， 因 为 较 小 的 修改 不 
会 导致 序列 化 后 的 日 期 无 效 。 这 是 种 中 肯 的 观点 。 然而， 尽管 会 不 方便 ， 但 失败 就 会 有 个 清晰 的 原因 。 另 一 方面 ， 如 果 
该 类 的 作者 忘记 更 新 序列 ID， 则 失败 模式 就 会 不 可 预期 ， 而 且 可 能 会 隐藏 得 很 深 。 我 认为 ， 这 个 故事 的 精髓 在 于 ， 不 
应 该 跨 版 本 做 反 序 列 化 处 理 。 

? Ri: [GOF]. 
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public abstract class DayDateFactory { 
private static DayDateFactory factory = new SpreadsheetDateFactory(): 
public static void setInstance(DayDateFactory factory) { | 
DayDateFactory.factory = factory; 
) Z 
protected abstract DayDate _makeDate (int ordinal); 
protected abstract DayDate _makeDate(int day, DayDate.Month month, int year); 
protected abstract DayDate _makeDate(int day, int month, int year); 
protected abstract DayDate _makeDate (java.util.Date date); 
protected abstract int _getMinimumYear (); 
protected abstract int .getMaximumYear(); 


public static DayDate makeDate(int ordinal) ( 
return factory. makeDate (ordinal); 
| 


public static DayDate makeDate(int day, DayDate.Month month, int year) ( 
return factory. makeDate(day, month, year); 
) 


public static DayDate makeDate(int day, int month, int year) ( 
return factory. makeDate(day, month, year); 
) 


public static DayDate makeDate(java.util.Date date) (. 
return factory. makeDate (date); 


) 


public static int getMinimumYear() | 
return factory. getMinimumYear(); 


) 


public static int getMaximumYear() { 
return factory. getMaximumYear(); 


) 
) 


该 工厂 类 用 makeDate 方法 替代 了 createlnstance 方法 ， 前 者 的 名 称 稍 好 一 些 [N1]。 在 初 
始 状 态 下 ， 它 使 用 SpreadsheetDateFactory， 但 随时 可 以 使 用 其 他 工厂 。 委 托 到 抽象 方法 的 静 
态 方法 混合 采用 了 单 件 模式 〈SINGLETON)、 油 漆 工 模式 :和 抽象 工厂 模式 ?， 我 发 现 这 种 手 
段 很 有 用 。 E | 

SpreadsheetDateFactory 看 起 来 像 这 个 样子 ; 


public class SpreadsheetDateFactory extends DayDateFactory { 
public DayDate _makeDate(int ordinal) { 
return new SpreadsheetDate (ordinal); 


) 


! 原 注 : Ibid。 
? AYE: Ibid. 


258 第 16 章 重 构 SerialDate 


public DayDate _thakeDate(int day, DayDate.Month month, int year) { 
return new SpreadsheetDate (day, month, year); 
) ; | 


public DayDate _makeDate(int day, int month, int year) ( 
return new SpreadsheetDate(day, month, year); 


) 


public DayDate _thdkeDate (Date date) { 
final GregorianCalendar calendar = new EE SES 
calendar .SetTime (date); 
return new SpreadsheetDate( 
calendar.get(Calendar.DATE), 
DayDate.Month.make(calendar.get(Calendar:MONTH) + 1), 
calendar.get (Calendar.YEAR)); 
) 


protected int _getMinimumYear() { 
return SpreadsheetDate.MINIMUM_YEAR_SUPPORTED; 
} 


protected int _getMaximumYear() { f 
return SpreadsheetDate.MAXIMUM YEAR SUPPORTED; 
) 
) 


如 你 所 见 ， 我 已 经 把 MINIMUM YEAR SUPPORTED fil MAXIMUM YEAR SUPPORTED 
变量 移 到 了 它们 该 在 的 SpreadsheetDate 中 [G6]。 

DayDate 的 下 一 个 问题 是 第 109 行 的 日 期 常量 。 这 些 常量 我 们 之 前 

过 这 种 模式 ， 不 再 歼 述 。 你 可 以 在 最 终 的 代码 清单 中 看 到 。 

跟着 ， 我 们 看 到 第 140 行 一 系列 以 LAST DAY OF MONTH 开头 的 数组 。 首 先 ， 描 述 这 
些 数组 的 注释 全 属 多 余 [C3]。 光 看 名 称 就 够 了 。 所 以 我 要 删除 这 些 注释 。 

”这 个 数组 没 理 由 不 是 私有 的 [G8]， 因 为 有 个 静态 函数 lastDayOfMonth 提供 同样 的 数据 。 

下 一 个 数组 AGGREGATE DAYS TO END .OF MONTH 更 神秘 一 些 ， 在 JCommon 框 
架 中 根本 没 用 到 它 [G9]。 所 以 我 直接 删除 了 。 | | 

对 于 LEAP. YEAR. AGGREGATE DAYS TO END OF MONTH 也 一 样 。 

AGGREGATE DAYS TO END OF PRECEDING MONTH 只 在 SpreadsheetDate 中 用 到 
(第 434 1181 473 行 )。 是 否 把 它 移 到 SpreadsheetDate 中 去 是 个 问题 。 不 转移 的 理由 是 ， 该 数 
组 并 不 专属 于 任何 特定 的 实现 [G6]. 另 一 方面 , 实际 上 并 不 存在 SpreadsheetDate 之 外 的 实现 ， 
所 以 ， 数 组 应 该 移 到 靠近 其 使 用 位 置 的 地 方 [G10]。 

说 服 我 的 理由 是 保持 一 致 [G11], 数组 应 该 私有 , 并 通过 类 似 et 
这 样 的 函数 来 暴露 。 看 来 没 人 需要 那样 的 函数 。 而 且 ， 如 果 有 新 的 DayDate 实现 需要 该 数组 ， 
可 以 轻易 地 把 它 移 回 到 DayDate 中 去 。 所 以 我 就 把 它 移 到 SpreadsheetDate 里 面 了 。 

对 于 LEAP YEAR. AGGREGATE DAYS_TO_END_OF_MONTH. 也 一 样 。 
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跟着 ， 我 们 看 到 三 组 可 以 转换 为 枚 举 的 常量 162—205 行 )。 第 一 个 用 来 选择 月 份 中 
的 一 周 。 我 将 其 转换 为 名 为 WeekInMonth 的 枚 举 。 


public enum WeekInMonth { | 
FIRST(1), SECOND(2), THIRD(3), FOURTH (4), LAST (0); 
pure final int index; 


WeekInMonth(int index) { 
this.index = index; 

} 

第 二 组 常量 (第 177—187 47) A AAR. INCLUDE NONE. INCLUDE FIRST, 
INCLUDE. SECOND 和 INCLUDE_BOTH 常量 用 于 描述 某 个 范围 的 终止 日 是 否 包含 在 该 范围 
之 内 。 数 学 上 ， 用 术语 “开放 区 间 ”、“ 半 开放 区 间 ” 和 “闭合 区 间 ” 来 表示 。 我 想 ， 用 数学 
术语 来 命名 会 更 清晰 [N3]， 所 以 就 将 其 转换 为 枚 举 DateInterval， 其 中 包括 CLOSED. 
CLOSED LEFT. CLOSED RIGHT 和 OPEN 枚 举 元 素 。 

第 三 组 常量 (第 18—205 行 ) 描述 了 是 否 该 在 最 后 、 下 一 个 或 最 近 的 日 期 实体 中 呈现 对 
” 某 个 星期 的 特定 一 天 的 查找 结果 。 怎 么 命名 是 个 难题 。 最 终 ， 我 给 WeekdayRange 设 定 了 
LAST. NEXT 和 NEAREST 枚 举 元 素 。 

你 也 许 不 会 同意 我 取 的 名 字 。 对 我 而 言 这 些 名 字 有 意义 ， 但 对 你 可 能 就 不 然 。 要 点 是 它 
们 眼下 变 成 了 易于 修改 的 形式 [J3]。 不 再 以 整数 形式 传递 ， 而 是 作为 符号 传递 。 我 可 以 用 IDE 
的 “修改 名 称 ” 功 能 来 改动 名 称 或 类 型 ， 无 需 担忧 漏 掉 代 码 中 某 处 -1 或 2 之 类 的 数字 ， 也 不 
必 担 忧 某 些 int 参数 声明 处 于 描述 不 佳 的 状态 。 \ 

第 208 行 的 描述 字段 看 来 没有 任何 地 方 用 到 。 我 把 它 及 其 取 值 器 和 赋值 器 都 删 掉 了 。 

我 还 删除 了 第 213 行 的 默认 构造 器 [G12]。 编 译 器 会 为 我 们 自动 生成 的 。 | 

Rg it isValidWeekdayCode PZ (58 216—238 行 )， 在 创建 Day 枚 举 时 已 经 把 它 删 掉 了 。 

于 是 来 到 stringToWeekdayCode 方法 (第 242—270 行 )。 没 有 方法 签名 增添 价值 的 Javadoc 
都 是 废话 [C3]、[G12]， 唯 一 的 价值 是 对 返回 值 一 1 的 描述 。 然 而 ， 因 为 我 们 改 用 了 Day 枚 举 ， 
这 条 注释 就 完全 错误 了 [C2]。 该 方法 现在 抛 出 一 个 EE 所 以 我 删 
除了 Javadoc。 

我 还 删除 了 参数 和 变量 声明 中 的 全 部 final 关键 字 。 我 敢 说 ， 它 们 毫 无 价值 ， 空 自 混淆 视 
听 惑 [G12]。 删 除 这 些 final， 不 合 某 些 成 例 。 例 如 ， Robert Simmons 就 强烈 建议 我 们 “……… 
在 代码 中 遍布 final。 ”我 不 能 苟同 。 我 认为 ，final 有 少数 的 好 用 法 ， 例 如 偶尔 使 用 的 final 常 
量 ， 但 除 此 之 外 该 关键 字 利 小 于 弊 。 我 这 么 认为 ， 或 许 是 因为 final 可 能 捕获 到 的 那些 错误 类 
型 ， 早 已 被 我 编写 的 单元 测试 捕获 了 。 

我 不 喜欢 for 循环 〈 第 259 行 和 263 行 ) 中 的 那些 让 语句 [G$]， 所 以 我 利用 “|| ”操作 符 


! 原 注 ，[Simmons04], p. 73. 
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把 它们 连接 为 单个 证 语句 。 我 还 使 用 Day 枚 举 整 理 for 循环 ， 做 了 一 些 装饰 性 的 修改 。 

我 认为 ， 这 个 方法 并 不 真 属于 DayDate 类 。 它 其 实 是 Day 的 一 个 解析 函数 。 所 以 ， 我 将 
它 移 到 Day 枚 举 中 。 不 过 ,那样 Day 枚 举 就 会 变 得 太 大 .因为 Day 的 概念 并 不 依赖 于 DayDate, 
我 就 把 Day 枚 举 移 到 DayDate 类 之 外 ， 放 到 它 自 己 的 源 代码 文件 中 。 

我 还 把 下 一 个 函数 ，weekdayCodeToString ($ 272—286 行 )， 移 植 到 Day MASP, HH 
为 toString。 


public enum Day { 
MONDAY (Calendar.MONDAY), 
TUESDAY (Calendar.TUESDAY), | 
WEDNESDAY (Calendar.WEDNESDAY),s 
THURSDAY (Calendar.THURSDAY), 
FRIDAY (Calendar.FRIDAY), 

. SATURDAY (Calendar.SATURDAY), 
SUNDAY (Calendar.SUNDAY); 


public final int index; 
private static DateFormatSymbols dateSymbols - new DateFormatSymbols(); 


Day(int day) ( 
index = day; 


) 


public static Day make (Int index) throws IllegalArgumentException { 
for (Day d : Day.values()) 
if (d.index == index) 
return d; | 
throw new IllegalArgumentException( 
String.format("Illegal day index: $d.", index)); 
) 


public static Day parse(String s) throws IllegalArgumentException { 
String[] shortWeekdayNames - 
dateSymbols.getShortWeekdays (); 
String[] weekDayNames - 
dateSymbols.getWeekdays (); 


S = s.trim();- 
for (Day day : Day.values()) { 
if (s.equalsIgnoreCase (shortWeekdayNames[day.index]) || 
s.equalsIgnoreCase (weekDayNames [day.index])) { 
return day; 
) 
) 
throw new IllegalArgumentException( 
String.format("$s is not a valid weekday string", s)); 


) 


public String toString() { 
return dateSymbols.getWeekdays () [index]; 
) 
) 
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有 两 个 getMonth 函数 第 288 一 316 行 )。 第 一 个 函数 调用 第 二 个 函数 。 第 二 个 函数 只 被 
第 一 个 函数 调用 。 所 以 , 我 把 这 两 个 函数 合 二 为 一 ， 而 且 极 大 地 简化 之 [G9][G12][F4]。 最 后 ， 
我 把 名 称 修改 得 更 具 目 我 描述 力 [N1]。 

public static String[] getMonthNames () { 


return dateFormatSymbols.getMonths (); 
) 


由 于 有 了 Month 枚 举 ， 函 数 isValidMonthCode (第 326—346 47) 就 变 得 没什么 用 ， 所 以 

我 把 它 删 除了 [G9]。 | 
函数 monthCodeToQuarter (第 356—375 íT) 有 特性 依恋 (FEATURE ENVY) ! 的 味道 ， 

可 以 是 Month 枚 举 中 的 一 个 名 为 quarter 的 方法 ， 我 就 这 么 办 了 。 


public int quarter () { 
return 1 + (index-1) /3; 
} 


这 样 一 来 ，Month 枚 举 就 大 到 需要 放 到 自己 的 类 中 了 。 我 把 它 从 DayDate 中 移出 来 ， 与 
Day 枚 举 保持 一 致 [G11][G13]。 

下 两 个 方法 被 命名 为 monthCodeToString (第 377—426 íT). 我 们 再 次 看 到 其 中 一 个 方法 
使 用 标识 调用 其 兄弟 方法 的 模式 。 将 标识 作为 参数 传递 给 函数 的 做 法 通常 不 太 好 ， 尤 其 是 当 
该 标识 只 是 有 关 其 输出 格式 时 [G15]。 我 重 命名 、 简 化 、 重 新 构架 了 这 些 函 数 ， 并 把 它们 移 到 
Month 枚 举 中 [N1][N3][G14]。 


public String toString() { 
return dateFormatSymbols.getMonths() [index - 1]; 
) 


public String toShortString() { 
return dateFormatSymbols.getShortMonths () [index - 1]; 
) : 


下 一 个 方法 是 stringToMonthCode (第 428—472 行 )。 我 重新 为 它 命名 ， 转 移 到 Month 
枚 举 中 ， 并 且 简 化 之 [N1][N3][C3][G14][G12]。 | 


public static Month parse(String s) { 
S = s.trim(); | 
for (Month m : Month.values()) 
if (m.matches(s)) 
return m; 


try { 
return make (Integer.parseInt (s)); 
) 
catch (NumberFormatException e) {} 
throw new IllegalArgumentException("Invalid month ”+ s); 


' FAYE: [Refactoring]. 
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private boolean matches(String s) { 
return s.equalsIgnoreCase(toString()) |l 
s.equalsIgnoreCase (toShortString()); 


方法 isLeapYear (38 495—517 41). 可 以 写 得 更 具 表 达 力 一 些 [G16]。 


public static boolean isLeapYear(int year) ( 
boolean fourth = year $ 4 == 0; | 
boolean hundredth = year $ 100 == 0; 
boolean fourHundredth = year % 400 == 0; 
return fourth && (!hundredth || fourHundredth) ; 





| 3 
下 一 个 函数 leap YearCount (第 519~536 £1) 并 不 真 属于 DayDate. KT SpreadsheetDate 
中 的 两 个 方法 外 ， 没 有 其 他 调用 者 。 所 以 我 将 它 往 下 放 。 a 

函数 lastDayOfMonth (35 538—560 íT) 使 用 了 LAST DAY OF MONTH 数组 。 该 数组 ` 
应 该 隶属 于 Month 枚 举 [G17]， 所 以 我 就 把 它 移 到 那儿 去 了 。 我 还 简化 了 这 个 函数 ， 使 其 更 “ 
具 表 达 力 [G16]。 


public static int lastDayOfMonth(Month month, int year) { 
if (month -- Month.FEBRUARY && isLeapYear(year)) 
return month.lastDay() * 1; 
else 
return month.lastDay(); 


) 

现在 ， 事 情 变 得 比较 有 趣 一 些 了 。 下 一 个 函数 是 addDays ($ 562—576 行 )。 首 先 ， 
由 于 该 函数 对 DayDate 的 变量 进行 操作 ， 它 就 不 该 是 静态 的 [G181]。 上 所 以 ， 我 把 它 修改 为 
实体 方法 。 其 次 ， 它 调用 了 函数 toSerial。 这 个 函数 应 该 重新 命名 为 toOrdial [N1]。 最 后 ， 
该 方法 可 以 简化 。 


public DayDate addDays (int days) { 
return DayDateFactory.makeDate(toOrdinal() + days); 


) 

对 于 addMonth (第 578—602 47) 也 一 样 。 它 应 该 是 个 实体 方法 [G18]。 算 法 太 过 复杂 ， 
所 以 我 利用 解释 临时 变量 模式 (EXPLAINING TEMPORARY VARIABLES )! 来 使 其 更 为 透明 。 
我 还 将 方法 getYYY 重 命名 为 getYear [N1]。 


public DayDate addMonths(int months) { 
int thisMonthAsOrdinal = 12 * getYear() + getMonth().index - 1; 
int resultMonthAsOrdinal = thisMonthAsOrdinal + months; 
int resultYear = resultMonthAsOrdinal / 12; 
Month resultMonth = Month.make(resultMonthAsOrdinal $ 12 + 1); 
int lastDayOfResultMonth = lastDayOfMonth(resultMonth, resultYear); 


' 原 注 : [Beck97]. 
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int resultDay = Math.min(getDayOfMonth(), lastDayOfResultMonth); 
return DayDateFactory.makeDate(resultDay, resultMonth, resultYear); 


) 
对 于 函数 addYear (第 604—626 1T) 也 照 方 办 理 。 


public DayDate plusYears (int years) { 
int resultYear = getYear() + years; 
int lastDayOfMonthInResultYear = lastDayOfMonth (getMonth(), EE 
int resultDay = Math.min(getDayOfMonth(), lastDayOfMonthInResultYear); 
return DayDateFactory.makeDate(resultDay, getMonth(), resultYear); 


) 

把 这 些 方法 从 静态 方法 变 为 实体 方法 ， 让 我 有 点 心头 发 痒 。 用 date.addDays(5) 这 样 的 表 
达 方 法 , 是 不 是 明确 地 表示 了 date 对 象 并 没 变动 以 及 返回 了 一 个 DayDate 的 新 实体 呢 ? 或 者 ， 
它 只 是 错误 地 暗示 我 们 往 date 对 象 添加 了 5 RE? 你 可 能 不 会 认为 这 是 个 大 问题 ， 但 下 列 代 
码 却 可 能 会 有 欺骗 性 。 


DayDate date = DateFactory.makeDate(5, Month.DECEMBER, 1952); 
date.addDays(7); // bump date by one week. 


有 些 读 到 这 段 代 码 的 人 会 认为 addDays 在 修改 date 对 象 。 所 以 ， 我 们 需要 消除 这 种 歧义 
的 名 称 [N4]。 我 把 名 称 改 为 plusDays 和 plusMonths。 我 认为 ， 方 法 的 初衷 很 清楚 地 被 
DayDate date = oldDate.plusDays (5); 
所 体现 ， 不 过 下 列 代码 对 认为 date 对 象 被 修改 的 读者 来 说 ， 看 起 来 并 不 那么 顺畅 : 
date.plusDays (5); 


算法 越 来 越 有 趣 ，getPreviousDayOfWeek (第 628—660 1T) 可 以 工作 , 不 过 有 点 复杂 了 。 
经 过 一 番 思 考 ， 了 解 到 它 的 功能 后 [G21]， 我 就 能 够 使 用 解释 临时 变量 模式 来 简化 它 [G19]， 
使 其 更 为 清晰 。 我 还 将 它 从 静态 方法 改 为 实体 方法 [G18]， 并 删除 了 重复 的 实体 方法 [G5] CA 
997— 1008 行 )。 


public DayDate getPreviousDayOfWeek(Day targetDayOfWeek) { 
int offsetToTarget - targetDayOfWeek.index - getDayOfWeek().index; 
if (offsetToTarget >= 0) 
offsetToTarget -= 7; 
return plusDays (offsetToTarget); 
) 


对 getFollowingDayOfWeek (3% 662—693 47) 也 如 法 炮制 


public DayDate geétFollowingDayOfWeek(Day targetDayOfWeek) { 
int offsetToTarget - targetDayOfWeek.index - getDayOfWeek().index; 
if (offsetToTarget «- 0) 
offsetToTarget += 7; 
return plusDays (offsetToTarget) ; 
E. 


下 一 个 函数 是 我 们 之 前 修改 过 的 getNearestDayOfWeek (第 695—726 行 )。 我 之 前 所 做 的 
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修改 和 前 两 个 函数 没有 保持 一 致 [G11]。 所 以 我 将 它 改 得 和 这 两 个 函数 保持 一 致 并 且 使 用 解 
释 临 时 变量 模式 [G19] 来 阐明 算法 。 
public DayDate getNearestDayOfWeek(final Day targetDay) ( 
int offsetToThisWeeksTarget = targetDay.index - getDayOfWeek().index; 


int offsetToFutureTarget = (offsetToThisWeeksTarget + 7) $ 7; 
int offsetToPreviousTarget = offsetToFutureTarget - 7; 


if (offsetToFutureTarget » 3) 

return plusDays (offsetToPreviousTarget); 
else i 

return plusDays (offsetToFutureTarget); 


方法 getEndOfCurrentMonth (R 728—740 行 ) 有 点 奇怪 ， 因 为 它 获 取 了 DayDate 参数 ， 
从 而 成 为 一 个 依恋 [G14] 其 自身 类 的 实体 方法 。 我 将 其 改 为 真正 的 实体 方法 ， 并 修改 了 几 
个 名 称 。 


public DayDate getEndOfMonth() { 

Month month = getMonth(); 

int year = getYear(); 

int lastDay = lastDayOfMonth (month, year); 

return DayDateFactory.makeDate(lastDay, month, year); 


) 


重 构 weekInMonthToString (第 742—761 47) 的 过 程 非常 有 趣 。 利 用 IDE 的 重 构 工 具 ， 
我 先 将 其 移 到 我 之 前 创建 的 WeekInMonth 枚 举 中 ， 再 将 其 重 命名 为 toString。 跟 着 ， 我 把 它 
从 静态 方法 改 为 实体 方法 。 所 有 的 测试 都 通过 了 。 (你 能 猜 出 来 我 打算 做 什么 吗 ? ) 

接 下 来 ， 我 删 掉 了 整个 方法 ! AS 个 断言 失败 了 《第 411 一 415 行 ， 代 码 清单 B-4)。 我 
改动 了 这 些 代码 行 ， 让 它们 使 用 枚 举 元 素 的 名 称 (FIRST、SECOND……)。 全 部 测试 都 通过 
了 。 你 知道 为 什么 吗 ? 你 能 否 知 道 为 什么 这 些 步骤 都 是 必要 的 吗 ? 重 构 工具 确保 之 前 对 
weekInMonthToString 方法 的 调用 现在 都 调用 weekInMonth 枚 举 元 素 的 toString 方法 ， 全 部 枚 
举 元 素 都 以 返回 其 名 称 的 形式 实现 了 toString 方法 ……: 

我 不 幸 有 点 聪明 过 头 了 。 这 一 套 美妙 的 重 构 下 来 ， 我 终于 意识 到 ， 这 个 函数 的 唯一 调用 
者 ， 就 是 我 刚 修改 的 测试 ， 所 以 我 删除 了 这 些 测试 。 

ARK, ERZI BRAK, PRA! 所 以 ， 在 判定 除了 测试 之 外 没有 人 调用 过 
relativeToString (58 765—781 行 ) 后 ， 我 就 删除 了 该 函数 及 其 测试 。 | 

我 们 最 后 将 其 改 为 这 个 抽象 类 的 抽象 方法 。 第 一 个 函数 保持 了 原样 : toSerial (第 838~ 
844 行 )。 前 文 我 曾 把 名 称 改 为 toOrdinal。 以 现在 的 情形 看 ， 我 决定 应 该 把 名 称 改 为 
getOrdinalDay。 | 

下 一 个 抽象 方法 是 toDate C28 838—844 行 )。 它 将 DayDate 转换 为 java.util.Date。 这 个 
方法 为 何 是 抽象 的 ? 查看 其 在 SpreadsheetDate 中 的 实现 〈 第 198—207 行 ， 代 码 清单 B-5), 
可 以 看 到 它 并 不 依赖 于 该 类 的 实现 [G6]。 所 以 ， 我 把 它 往 上 推 了 。 
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方法 getYYYY、getMonth 和 getDayOfMonth 已 经 是 抽象 方法 。 不 过 ，getDayOfWeek 方 
法 是 另 一 个 应 该 从 SpreadsheetDate 中 提出 来 的 方法 ， 因 为 它 不 依赖 于 DayDate 之 外 的 东西 
[G6]。 是 这 样 吗 ? 

仔细 阅读 (第 247 行 ， 代 码 清单 B-5)， 可 以 发 现 该 算法 暗中 依赖 于 顺序 日 期 的 起 点 〈 换 
言 之 ， 第 0 天 的 星期 日 数 )， 所 以 ， 即 便 该 方法 没有 物理 上 的 依赖 ， 也 不 能 移 到 DayDate 中 ， 
因为 它 的确 有 逻辑 上 的 依赖 。 

这 样 的 逻辑 依赖 困扰 了 我 [G22]。 如 果 有 什么 东西 在 逻辑 上 依赖 实现 的 话 ， 也 该 有 什么 物 
理 上 的 依赖 存在 。 我 也 认为 ， 算 法 本 身 也 该 有 一 小 部 分 依赖 于 实现 。 

所 以 我 在 DayDate 中 创建 了 一 个 名 为 getDayOfWekForOrdinalZero 的 抽象 方法 ， 并 在 
SpreadsheetDate 中 实现 它 ， 返 回 Day.SATURDAY。 然 后 我 把 getDayOfWeek 上 移 到 DayDate 
中 ， 并 调用 getOrdinalDay 和 getDayOfWeekForOrdinal Zero。 

public Day. getDayOfWeek() { 

Day startingDay = getDayOfWeekForOrdinalZero(); 
int startingOffset = startingDay.index - Day.SUNDAY.index; 
return Day.make((getOrdinalDay() * startingOffset) $ 7 * 1); 

) 

顺便 说 一 句 ， 请 仔细 阅读 第 895—899 行 的 注释 。 这 样 的 重复 有 必要 吗 ? 通常 ,我 会 删除 

下 一 个 方法 是 compare (第 902—913 行 )。 同 样 ， 该 抽象 方法 是 不 恰当 的 [G6]。 我 将 其 
实现 上 移 到 DayDate。 其 名 称 也 不 足够 有 沟通 意义 [N1]。 方 法 实际 上 返回 的 是 自 参 数 日 期 以 
来 的 天 数 ， 所 以 我 把 名 称 改 为 daysSince。 我 还 注意 到 该 方法 没有 测试 ， 就 为 它 编写 了 测试 。 

Fil 6 个 函数 CB 915—980 行 ) 全 都 是 应 该 在 DayDate 中 实现 的 抽象 方法 。 我 把 它们 
全 都 从 SpreadsheetDate 中 抽出 来 了 。 

最 后 一 个 函数 isInRange (第 982—995 T) 也 需要 推 到 上 一 层 并 重 构 之 。 那 个 switch 语 
人 句 有 扩 丑 陋 [G23]， 可 以 把 那些 条 件 判 断 移 到 DateInterval 枚 举 中 去 。 | 

public enum DateInterval ( 

OPEN { 
public boolean isIn(int d, int left, int don. { 
return d > left && d < right; 
) 
ee { 
public boolean isIn(int d, int left, int right) { 
return d >= left && d « right; 
) 
TT ( 
public boolean isIn(int d, int left, int right) ( 
return d > left && d <= right; 
) 
hn 
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CLOSED { | 
public boolean isIn(int d, int left, int right) ( 
return d >= left && d <= right; 
} 
}; 


public abstract boolean isIn(int d, int left, int right); 
) 


public boolean isInRange(DayDate dl, DayDate d2, DateInterval interval) ( 
int left = Math.min(dl.getOrdinalDay(), d2.getOrdinalDay()); 
int right - Math.max(dl.getOrdinalDay(), d2.getOrdinalDay()); 
return interval.isIn(getOrdinalDay(), left, right); 

) . 


我 们 来 到 了 DayDate 的 末尾 。 现 在 我 们 要 从 头 到 尾 再 过 一 次 ， 看 看 整个 重 构 过 程 是 怎样 
良好 执行 的 。 

首先 ， 开 端 注 释 过 时 已 久 ， 我 缩短 并 改进 了 它 [C2]。- 

然后 ， 我 把 全 部 枚 举 移 到 它们 自己 的 文件 中 [G12]。 

跟着 , 我 把 静态 变量 (dateFormatSymbols) 和 3 个 静态 方法 (getMonthNames、 isLeapYear 
和 lastDayOfMonth) 移 到 名 为 DateUtil 的 新 类 中 [G6]。 

我 把 那些 抽象 方法 上 移 到 它们 该 在 的 项 层 类 中 [G24]。 

我 把 Month.make 改 为 Month.fromInt [N1]， 并 如 法 炮制 所 有 其 他 枚 举 。 我 还 为 全 部 枚 举 
创建 了 tolnt( ) 访 问 器 ， 把 index 字段 改 为 私有 。 

在 plusYears 和 plusMonths 中 存在 一 些 有 趣 的 重复 [G5]， 我 通过 抽 离 出 名 为 
correctLastDayOfMonth 的 新 方法 消解 了 重复 ， 使 这 3 个 方法 清晰 多 了 。 

我 消除 了 魔术 数 1 [G25]， 用 Month.JANUARY.toInt( )8&& Day.SUNDAY:toInt( ) 做 了 恰 
当 的 替换 。 我 在 SpreadsheetDate Ete D STIS, 清理 了 一 下 算法 。 最 终结 结 采 在 代码 清单 
B-7~ 16 中 。 

有 趣 的 是 ，DayDate 的 代码 覆盖 率 降 低 到 了 84.9%! 这 并 不 是 因为 测试 到 的 功 和 8 减少 了 ， 
而 是 因为 该 类 缩减 得 太 多 ， 导 致 少量 未 覆盖 到 的 代码 行 拥有 了 更 大 权重 。DayDate 的 53 个 可 
执行 语句 中 有 45 个 得 到 测试 覆盖 。 未 履 盖 的 代码 行 微细 到 不 值得 测试 。 


16.3 小结 


我 们 再 一 次 遵从 了 童子 军 军 规 。 我 们 签 入 的 代码 ， 要 比 签 出 时 整 洲 了 一 点 。 虽 然 花 了 所 
时 间 ， 不 过 很 值得 。 测 试 履 盖 率 提升 了 ， 修 改 了 一 些 缺 陷 ， 代 码 清 晰 并 缩短 了 。 后 来 者 有 望 
比 我 们 更 容易 地 应 付 这 些 代码 。 他 也 有 可 能 把 代码 整理 得 更 干净 些 。 
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Martin Fowler ÆW Refectoring: Improving the Design of Existing Code! 中 指出 了 许多 不 
同 的 “代码 味道 ”。 下 面 的 清单 包括 很 多 Martin 提出 的 味道 ， 还 添加 了 更 多 我 自 己 提 出 的 ， 
也 包括 我 借以 历练 本 业 的 其 他 珍宝 与 启发 。 
我 项 由 遍 览 和 重 构 几 个 不 同 的 程序 总 结 出 这 个 清单 。 每 次 修改 ， 我 都 问 自己 为 什么 要 这 
样 改 ， 把 修改 的 原因 写 下 来 。 绪 果 就 是 得 到 相当 长 的 清单 ， 给 出 在 读 代码 时 让 我 闻 起 来 不 舒 


' JRE: [Refactoring]. 
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服 的 味道 。 
清单 应 按 顺序 阅读 ， 并 作为 一 种 参考 来 使 用 。 


17.1 注释 


C1: 不 恰当 的 信息 


让 注释 传达 本 该 更 好 地 在 源 代码 控制 系统 、 问 题 追踪 系统 或 任何 其 他 记录 系统 中 保存 的 
信息 ， 是 不 恰当 的 。 例 如 ， 修 改 历史 记录 只 会 用 大 量 过 时 而 无 趣 的 文本 搞 乱 源 代码 文件 。 通 
常 ， 作 者 、 最 后 修改 时 间 、SPR 数 等 元 数据 不 该 在 注释 中 出 现 。 注 释 只 应 该 描述 有 关 代码 和 
设计 的 技术 性 信息 。 

C2: 废弃 的 注释 


过 时 、 无 关 或 不 正确 的 注释 就 是 废弃 的 注释 。 注 释 会 很 快 过 时 。 最 好 别 编写 将 被 废弃 的 
注释 。 如 果 发 现 废弃 的 注释 ， 最 好 尽快 更 新 或 删除 掉 。 废 弃 的 注释 会 远离 它们 曾经 描述 的 代 
码 ， 变 成 代码 中 无 关 和 误导 的 浮 岛 。 | 

C3. TATE 


如 采 注 释 指 述 的 是 茶 种 充分 目 我 描述 了 的 东西 ， 那 么 注释 就 是 多 余 的 。 例 如 


i++; // increment i 


另 一 个 例子 是 除 函 数 签名 之 外 什么 也 没 多 说 (或 少 说 ) 的 Javadoc: 
/** 


* (iparam sellRequest 
* (return ` 


* @throws ManagedComponentException 
*7 


public SellResponse beginSellItem(SellRequest sellRequest) 
throws ManagedComponentException 


注释 应 该 谈 及 代码 自身 没 提 到 的 东西 。 
C4, MERE 


值得 编写 的 注释 ， 也 值得 好 好 写 。 如 果 要 编写 一 条 注释 ， 就 化 时 间 保证 写 出 最 好 的 注释 。 
字 项 句 酌 。 使 用 正确 的 语法 和 拼写 。 别 闲 扯 ， 别 画蛇添足 ， 保 持 简 洁 。 


C5; 注释 控 的 代码 
看 到 被 注释 掉 的 代码 会 令 我 抓 狂 。 谁 知道 它 有 多 旧 ? 谁 知 道 它 有 没有 意义 ? 没 人 会 删除 
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它 ， 因 为 大 家 都 假设 别人 需要 它 或 是 有 进一步 计划 。 | 
那样 的 代码 就 这 样 腐烂 掉 ， 随 着 时 间 推 移 ， 越 来 越 与 系统 没关系 。 它 调用 不 复 存 在 的 函 
数 。 它 使 用 已 改名 的 变量 。 它 遵循 已 被 废弃 的 约定 。 它 污染 了 所 属 的 模块 ， 分 散 了 想 要 读 它 
的 人 的 注意 力 。 注 释 掉 的 代码 纯 属 厌 物 。 
看 到 注释 掉 的 代码 ， 就 删除 它 ! 别 担心 ， 源 代码 控制 系统 还 会 记得 它 。 如 果 有 人 真 的 需 
要 ， 可 以 签 出 较 前 的 版 本 。 别 被 它 搞 到 死去 活 来 。 


17.2 “环境 


E1: 需要 多 步 才 能 实现 的 构建 


构建 系统 应 该 是 单 步 的 小 操作 。 不 应 该 从 源 代码 控制 系统 中 一 小 点 一 小 点 签 出 代码 。 
不 应 该 需要 一 系列 神秘 指令 或 环境 依赖 脚本 来 构建 单个 元 素 。 不 应 该 四 处 寻找 额外 的 小 
JAR、XML 文件 和 其 他 系统 所 需 的 杂 物 。 你 应 当 能 够 用 单个 命令 签 出 系统 ， 并 用 单个 指 
令 构建 它 。 | 

svn get mySystem 


cd mySystem 
ant all 


E2. 需要 多 步 才能 做 到 的 测试 


你 应 当 能 够 发 出 单个 指令 束 可 以 运行 全 部 单元 测试 。 能 够 运行 全 部 测试 是 如 此 基础 和 重 
要 ， 应 该 快速 、 轻 易 和 直截了当 地 做 到 。 | 


173 BH 


F1: 过 多 的 参数 
函数 的 参数 量 应 该 少 。 没 参数 最 好 ， 一 个 次 之 ， 两 个 、 三 个 再 次 之 。 三 个 以 上 的 参数 非 
常 值 得 质疑 ， 应 坚决 避免 。( 参 见 前 文 “函数 参数 ”一 节 ,。) 
F2， 输出 参数 | 


输出 参数 违反 直觉 。 读 者 期 望 参数 用 于 输入 而 非 输出 。 如 果 函 数 非 要 修改 什么 东西 的 状 
态 不 可 ， 就 修改 它 所 在 对 和 象 的 状态 好 了 。( 参 见 前 文 “ 输 出 参数 ”一 节 .，) 
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F3. 标识 参数 


“布尔 值 参数 大 声 宣告 函数 做 了 不 止 一 件 事 。 CSR, MBO. (BATT HR 
识 参数 ”一 节 。) | 


F4， 死 函数 | 
永 不 被 调用 的 方法 应 该 丢弃 。 保 留 死 代 码 纯 属 浪费 。 别 害怕 删除 函数 。 记 住 ， 源 代码 控 
” 制 系 统 还 会 记得 它 。 


174 ”一般 性 问题 


G1: 一 个 源 文 件 中 存在 多 种 语言 

当今 的 现代 编程 环境 允许 在 单个 源 文件 中 存在 多 种 不 同 语言 。 例 如 ，Java 源 文件 可 能 还 
包括 XML, HTML, YAML, JavaDoc, X., JavaScript 等 语言 。 另 例 ，JSP 文件 可 能 还 包 
， 括 HTML、Java、 标 签 库 语 法 、 英 文 注释 、Javadoc、XML、JavaScript 等 。 往 好 处 说 是 令 人 
迷惑 ， 往 坏处 说 就 是 粗心 大 意 、 驳 杂 不 精 。 

理想 的 源 文件 包括 且 只 包括 一 种 语言 。 现 实 上 ， 我 们 可 能 会 不 得 不 使 用 多 于 一 种 语言 。 
但 应 该 尽力 减少 源 文件 中 额外 语言 的 数量 和 范围 。 


G2; 明显 的 行为 未 被 实现 

遵循 “最 小 惊异 原则 ”(The Principle of Least Surprise) “， 函 数 或 类 应 该 实现 其 他 程序 员 
有 理由 期 待 的 行为 。 例 如 ， 考 虑 一 个 将 日 期 名 称 翻译 为 表示 该 日 期 的 枚 举 的 函数 。 

Day day = DayDate.StringToDay(String dayName); 

我 们 期 望 字 符 串 Monday 翻译 为 Day. MONDAY . 我 们 也 期 望 常 用 缩写 形式 也 能 被 翻译 出 
来 ， 我 们 还 期 待 函数 忽略 大 小 写 。 

如 果 明 显 的 行为 未 被 实现 ， 读 者 和 用 户 就 不 能 再 依靠 他 们 对 函数 名 称 的 直觉 。 他 们 不 再 - 
信任 原作 者 ， 不 得 不 阅读 代码 细节 。 

G3: 不 正确 的 边界 行为 

| 代码 应 该 有 正确 行为 ， 这 话 看 似 明白 。 问 题 是 我 们 很 少 能 明日 正确 行为 有 多 复杂 。 开 发 

者 常常 写 出 他 们 以 为 能 工作 的 函数 ， 信 和 赖 自 己 的 直觉 ， 而 不 是 努力 去 证 明代 码 在 所 有 的 角落 
和 边界 情形 下 真能 工作 。 


! 原 注 ， 或 称 “ 最 少 惊 记 原则 ”(The Principle of Least Astonishment): 
http://en.wikipedia.org/wiki/Principle of least astonishment. 


17.4 一 般 性 问题 273 


没什么 可 以 替代 说 小 慎 微 。 每 种 边界 条 件 、 每 种 极端 情形 、 每 个 异常 都 代表 了 某 种 可 能 
搞 乱 优雅 而 直 和 白 的 算法 的 东西 。 别 依赖 直觉 。 追 索 每 种 边界 条 件 ， 并 编写 测试 。 


G4, 忽视 安全 


切 尔 诺 贝 利 核电 站 裔 塌 了 ， 因 为 电厂 经 理 一 条 又 一 条 地 忽视 了 安全 机 制 。 道 守 安 全 就 不 
便于 做 试验 。 结 果 就 是 试验 未 能 运行 ， 全 世界 都 目睹 首 个 民用 核电 站 大 灾难 。 

忽视 安全 相当 危险 。 手工 控制 serialVersionUID 可 能 有 必要 , 但 总 会 上 有 风险。 关闭 某 些 编 - 
译 器 警告 (或 者 全 部 警告 !) 可 能 有 助 于 构建 成 功 , 但 也 存在 陷于 无 穷 无 尽 的 调试 的 风险 。 关 
闭 失败 测试 、 告 诉 自己 过 后 再 处 理 ， 这 和 假装 刷 信 用 卡 不 用 还 钱 一 样 坏 。 

G5; 重复 

有 一 条 本 书 提 到 的 最 重要 的 规则 之 一 ， 你 应 该 非常 严肃 地 对 待 。 实 际 上 ， 每 位 编写 有 关 
软件 设计 的 作者 都 提 到 这 条 规则 。 Dave Thomas 和 Andy Hunt 称 之 为 DRY JAN (Don’t Repeat 
Yourself， 别 重复 自己 ) 。Kent Beck 将 它 列 为 极限 编程 核心 原则 之 一 ， 并 称 之 为 “一 次 ， 
也 只 一 次 ” . Ron Jeffries 将 这 条 规则 列 在 第 二 位 ， 地 位 只 低 于 通过 所 有 测试 。 

每 次 看 到 重复 代码 , 都 代表 遗漏 了 抽象 。 重复 的 代码 可 能 成 为 子 程序 或 干脆 是 男 一 个 类 。 
将 重复 代码 释放 进 类 似 的 抽象 ， 增 加 了 你 的 设计 语言 的 词汇 量 。 其 他 程序 员 可 以 用 到 你 创建 
的 抽象 设施 。 编 码 变 得 越 来 越 快 ， 错 误 越 来 越 少 ， 因 为 你 提升 了 抽象 层级 。 

重复 最 明显 的 形态 是 你 不 断 看 到 明显 一 样 的 代码 ， 就 像 是 某 位 程序 员 疯 狂 地 用 鼠标 不 断 
复制 粘贴 代码 。 可 以 用 单一 方法 来 替代 之 。 

较 隐 项 的 形态 是 在 不 同 模块 中 不 断 重 复出 现 、 检 测 同一 组 条 件 的 switch/case 或 if/else 链 。 
可 以 用 多 态 来 替代 之 。 

更 隐蔽 的 形态 是 采用 类 似 算法 但 具体 代码 行 不 同 的 模块 。 这 也 是 一 种 重复 ， 可 以 使 用 模 
板 方法 模式 ?或 策略 模式 来 修正 。 

的 确 ， 过 去 15 年 内 出 现 的 多 数 设 计 模 式 都 是 消除 重复 的 有 名 手段 。 考 德 范 式 (Codd 
Normal Forms) 是 消除 数据 库 规划 中 的 重复 的 策略 。OO 自身 也 是 组 织 模块 和 消除 重复 的 策 
略 。 毫 不 出 奇 ， 结 构 化 编程 也 是 。 | | 

重点 已 经 在 那里 了 。 尽 可 能 找到 并 消除 重复 。 


G6: 在 错误 的 抽象 层级 上 的 代码 


创建 分 离 较 高 层级 一 般 性 概念 与 较 低层 级 细节 概念 的 抽象 模型 ， 这 很 重要 。 有 时 ， 我 们 
创建 抽象 类 来 容纳 较 高 层级 概念 ， 创 建 派生 类 来 容纳 较 低 层次 概念 。 这 样 做 的 时 候 ， 需 要 确 


| 原 注 : [FRAG]. 
2 MJE: [GOF]. 
3 原 注 : [GOF]. 
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保 分 离 完整 。 所 有 较 低层 级 概念 放 在 派生 类 中 ， 所 有 较 高 层级 概念 放 在 基 类 中 。 
例如 ， 只 与 细节 实现 有 关 的 常量 、 变量 或 工具 函数 不 应 该 在 基 类 中 出 现 。 基 类 应 该 对 
些 东 西 一 xs. 3 
这 条 规则 对 于 源 文件 、 组 件 和 模块 也 适用 。 良好 的 软件 设计 要 求 分 离 位 于 不 同 层级 的 概念 , 

将 它们 放 到 不 同 容器 中 。 有 时 ， 这 些 容器 是 基 类 或 派生 类 ， 有 时 是 源 文件 、 模 块 或 组 件 。 无 论 洁 

哪 种 情况 ， 分 离 都 要 完整 。 较 低 层级 概 信和 较 高 层级 概 售 不 应 混杂 在 一 起 。 AE Tmt: 3 


public interface Stack { 
Object pop() throws EmptyException; 
void push(Object o) throws FullException; 
double percentFull(); | 
class EmptyException extends Exception {} 
class FullException extends Exception {} 








) E 
函数 percentFull 位 于 错误 的 抽象 层级 。 尽 管 存在 许多 在 其 中 “充满 ”(fallness) 概念 有 E 
意义 的 Stack 的 实现 ， 但 也 有 其 他 不 能 知道 自己 有 多 满 的 实现 存在 。 所 以 ， 该 函数 最 好 是 放 … 
， 在 类 似 BoundedStack 之 类 的 派生 接口 中 。 3 

rtr n, 如 果 堆 栈 无 边界 ， 实 现 可 以 返回 0。 问题 是 ， 不 存在 真 的 无 边界 的 堆栈 。 | 
你 不 能 真 的 避免 在 做 以 下 检查 时 出 现 OutOfMemoryException 寞 常 : 

stack.percentFull() < 50.0. 

实现 返回 0 的 函数 可 能 是 在 撒谎。 | | . 

X SE PRA Be ROR RA i. ULL Ze CIT T IC PSOE RIGRU BU e, 
而 且 一 旦 做 错 也 没有 快捷 的 修复 手段 。 | 


. G7: 基 类 依赖 于 派生 类 


将 概念 分 解 到 基 类 和 派生 类 的 最 普遍 的 原因 是 较 高 层级 基 类 概念 可 以 不 依赖 于 较 低层 级 3 
派生 类 概念 这样， 如果 看 到 基 类 提 到 派生 类 名 称 ， 就 可 能 发 现 了 问题 。 通 常 来 说 ， 基 类 对 d 
派生 类 应 该 一 无 所 知 。 3 

当然 也 有 例外 。 有 时 ， 派 生 类 数量 严格 固定 ， 而 基 类 中 拥有 在 派生 类 之 间 选 择 的 代码 。 在 
有 限 状态 机 的 实现 中 这 种 情形 很 多 见 。 然 而 ， 在 那 种 情况 下 ， 派 生 类 和 基 类 紧密 耦合 ， 总 是 在 — 
同一 个 jar 文件 中 部 署 。 一 般 情况 下 ， 我 们 会 想 要 把 派生 类 和 基 类 部 署 到 不 同 的 jar 文件 中 。 

将 派生 类 和 基 类 部 署 到 不 同 的 jar 文件 中 ， 确 保 基 类 jar 文件 对 派生 类 jar 文件 的 内 容 一 
无 所 知 ， 我 们 就 能 把 系统 部 署 为 分 散 和 独立 的 组 件 。 修 改 了 这 些 组 件 时 ， 不 必 重新 部 署 基 组 
件 就 能 部 署 它们 。 这 意味 着 修改 产生 的 影响 极 大 地 降低 了 ， 而 维护 系统 也 变 得 更 加 简单 。 


G8; 信息 过 多 


设计 良好 的 模块 有 着 非常 小 的 接口 ， 让 你 能 事 半 蕊 倍 。 设 计 低 劣 的 模块 有 着 广阔 、 深 入 
的 接口 ， 你 不 得 不 事倍功半 。 设 计 民 好 的 接口 并 不 提供 许多 需要 依靠 的 函数 ， 所 以 耦合 度 也 


. gë Tc doe ; 
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较 低 。 设 计 低劣 的 借口 提供 大 量 你 必须 调用 的 函数 ， 耦 合 度 较 高 。 

优秀 的 软件 开发 人 员 学 会 限制 类 或 模块 中 暴露 的 接口 数量 。 类 中 的 方法 越 少 越 好 。 函 数 
知道 的 变量 越 少 越 好 。 类 拥有 的 实体 变量 越 少 越 好 。 

隐藏 你 的 数据 。 隐 藏 你 的 工具 函数 。 隐 藏 你 的 和 常量 和 你 的 临时 变量 。 不 要 创建 拥有 大 量 
方法 或 大 量 实体 变量 的 类 。 不 要 为 子 类 创建 大 量 受 保护 变量 和 函数 。 尽 力 保 持 接 口 紧凑 。 通 
过 限制 信息 来 控制 看 合 度 。 | 


G9; 死 代 码 


死 代码 就 是 不 执行 的 代码 。 可 以 在 检查 不 会 发 生 的 条 件 的 证 语句 体 中 找到 。 可 以 在 从 不 
抛 出 异常 的 try 语句 的 catch 块 中 找到 。 可 以 在 从 不 被 调用 的 小 工具 方法 中 找到 ， 也 可 以 在 永 
不 会 发 生 的 switch/case 条 件 中 找到 。 

死 代码 的 问题 是 过 不 久 它 就 会 发 出 臭 味 。 时 间 越 入， 味道 就 越 酸 身 。 这 是 因为 ， 在 设计 
改变 时 ， 死 代码 不 会 随 之 更 新 。 它 还 能 通过 编译 ， 但 并 不 会 遵循 较 新 的 约定 或 规则 。 它 编写 
的 时 候 ， 系 统 是 另 一 番 模 样 。 如 果 你 找到 死 代 码 ， 就 体面 地 埋葬 它 ， 将 它 从 系统 中 删除 掉 。 


G10: 垂直 分 隔 


变量 和 函数 应 该 在 靠近 被 使 用 的 地 方 定义 。 本 地 变量 应 该 正好 在 其 首次 被 使 用 的 位 置 上 
面 声明 ， 垂 直 距 离 要 短 。 本 地 变量 不 该 在 其 被 使 用 之 处 几 百 行 以 外 声明 。 

私有 函数 应 该 刚好 在 其 首次 被 使 用 的 位 置 下 面 定义 。 私 有 函数 属于 整个 类 ， 但 我 们 还 是 
要 限制 调用 和 定义 之 间 的 垂直 距离 。 找 个 私有 函数 ， 应 该 只 是 从 其 首次 被 使 用 处 往 下 看 一 点 
那么 简单 。 | 


G11: 前 后 不 一 致 


从 一 而 终 。 这 可 以 追 滴 到 最 小 惊异 原则 。 小 心 选择 约定 ， 一 旦 选中 ， 就 小 心 持续 遵循 。 

如 果 在 特定 函数 中 用 名 为 response 的 变量 来 持 有 HttpServletResponse 对 象 ， 则 在 其 他 用 
到 HttpServletResponse 对 象 的 函数 中 也 用 同样 的 变量 名 。 如 果 将 某 个 方法 命名 为 
processVerificationRequest, 则 给 处 理 其 他 请 求 类 型 的 方法 取 类 似 的 名 字 , 例如 processDeletion 


Request。 
如 此 简单 的 前 后 一 致 ， 一 旦 坚决 贯彻 ， 就 能 让 代码 更 加 易于 阅读 和 修改 。 


G12: 混 清 视听 


没有 实现 的 默认 构造 器 有 何 用 处 呢 ? 它 只 会 用 无 意义 的 杂碎 搞 乱 对 代码 的 理解 。 没 有 用 
到 的 变量 ， 从 不 调用 的 函数 ， 没 有 信息 量 的 注释 ， 等 等 ， 这 些 都 是 应 该 移 除 的 废物 。 保 持 源 
文件 整洁 ， 良 好 地 组 织 ， 不 被 搞 乱 。 | 
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G13: Ange 


不 互相 依赖 的 东西 不 该 耦合 。 例 如 ， 普 通 的 enum 不 应 在 特殊 类 中 包括 ， 因 为 这 样 一 来 应 
用 程序 就 要 了 解 这 些 更 为 特殊 的 类 。 对 于 在 特殊 类 中 声明 一 般 目的 的 static 函数 也 是 如 此 。 

一 般 来 说 ， 人 为 耦合 是 指 两 个 没有 直接 目的 之 间 的 模块 的 耦合 。 其 根源 是 将 变量 、 常 量 
或 函数 不 恰当 地 放 在 临时 方便 的 位 置 。 这 是 种 漫不经心 的 偷懒 行为 。 

人 论点 时 间 研 究 应 该 在 什么 地 方 声明 函数 、 常 量 和 变量 。 不 要 为 了 方便 随手 放置 ， 然 后 置 
之 不 理 。 | 


G14: 特性 依恋 


这 是 Martin Fowler 提出 的 代码 味道 之 一 。 类 的 方法 只 应 对 其 所 属 类 中 的 变量 和 函数 感 
兴趣 ， 不 该 垂青 其 他 类 中 的 变量 和 函数 。 当 方法 通过 某 个 其 他 对 象 的 访问 器 和 修改 器 来 操作 
该 对 象 内 部 数据 ， 则 它 就 依恋 于 该 对 象 所 属 类 的 范围 。 它 期 望 自己 在 那个 类 里 面 ， 这 样 就 能 
直接 访问 它 操作 的 变量 。 例 如 : 


public class HourlyPayCalculator { 
public Money calculateWeeklyPay (HourlyEmployee e) { 
int tenthRate = e.getTenthRate().getPennies(); 
int tenthsWorked = e.getTenthsWorked(); 
int straightTime - Math.min(400, tenthsWorked); 
int overTime = Math.max(0, tenthsWorked - straightTime); 
int straightPay = straightTime * tenthRate; 
int overtimePay = (int)Math.round(overTime*tenthRate*1.5); 
return new Money(straightPay * overtimePay); 
} 
} 


方法 calculateWeeklyPay 伸手 到 HourlyEmployee 对 象 ， 获 取 要 操作 的 数据 。 方 法 
calculateWeeklyPay 依恋 于 HourlyEmployee 的 作用 范围 。 它 “期 望 ” 目 己 在 HourlyEmployee F. 

同样 情况 下 ， 我 们 要 消除 特性 依恋 ， 因 为 它 将 一 个 类 的 内 部 情形 暴露 给 了 另外 一 个 类 。 
不 过 ， 有 时 特性 依恋 是 种 有 必要 的 恶 行 。 看 下 面 的 代码 ; 


public class HourlyEmployeeReport { 
private HourlyEmployee employee ; 


public HourlyEmployeeReport (HourlyEmployee e) { 
this.employee = e; 


) 


String reportHours() { 
return String.format( 
"Name: %s\tHours:%d.$ld\n", 
employee.getName(), 


! fiit: [Refactoring]. 
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employee.getTenthsWorked()/10, 

employee.getTenthsWorked () $10) ; 
} | 
) 


显然 ,reportHours 方法 依恋 于 HourlyEmployee 类 。 另 一 方面 ,我 们 并 不 想 要 HourlyEmployee 
得 知 报告 的 格式 。 把 格式 化 字符 串 移 到 HourlyEmployee 会 破坏 好 几 种 面向 对 象 设计 原则 '。 它 
将 把 HourlyEmployee 与 报告 的 格式 耦合 起 来 ， 向 该 格式 的 修改 暴露 这 个 类 。 


G15: 选择 算 子 参 数 


没有 什么 比 在 函数 调用 末尾 遇 到 一 个 false 参数 更 为 可 异 的 事情 了 。 那 个 false 是 什么 意 
思 ? 如 果 它 是 true, 会 有 什么 变化 吗 ? 不 仅 是 一 个 选择 算 子 selector) 参数 的 目的 难以 记 住 ， 
每 个 选择 算 子 参数 将 多 个 函数 绑 到 了 一 起 。 选 择 算 子 参数 只 是 一 种 避免 把 大 函数 切 分 为 多 个 
小 函数 的 偷懒 做 法 。 考 虑 下 面 这 段 代码 ; mE 


public int calculateWeeklyPay (boolean overtime) { 
int tenthRate = getTenthRate(); 
int tenthsWorked = getTenthsWorked(); 

- int straightTime - Math.min(400, tenthsWorked); 

int overTime - Math.max(0, tenthsWorked - straightTime); 
int straightPay = straightTime * tenthRate; 
double overtimeRate - overtime ? 1.5 : 1.0 * tenthRate; 
int overtimePay = (int)Math.round(overTime*overtimeRate); 
return straightPay + overtimePay; 


) 


当 加 班 时 间 以 一 倍 半 计算 薪资 时 ， 用 true 调用 这 个 函数 ，false 则 表示 直接 计算 。 每 次 用 
到 这 个 函数 ， 你 都 得 记 住 calculateWeeklyPay(false) 表 示 什 么 ， 这 已 经 足够 糟糕 了 。 但 这 种 函 
数 真 正 的 坏处 在 于 作者 错过 了 这 样 写 的 机 会 : 


public int straightPay() { 
return getTenthsWorked() * getTenthRate(); 
) 


public int overTimePay() { 
int overTimeTenths - Math.max(0, getTenthsWorked() - 400); 
int overTimePay = overTimeBonus (overTimeTenths); 
return straightPay() * overTimePay; 


) 


private int overTimeBonus(int overTimeTenths) ( 
double bonus = 0.5 * getTenthRate() * overTimeTenths; 
return (int) Math.round (bonus); 


当然 ， 选 择 算 子 不 一 定 是 boolean 头 型。 可 能 是 枚 举 元 素 、 整 数 或 任何 一 种 用 于 选择 函 


| RE: 具体 是 单一 权 责 原则 ， 开 放 闭 合 原则 和 公共 关闭 原则 。 参 见 [PPP]。 
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数 行为 的 参数 。 使 用 多 个 函数 ， 通 常 优 于 向 单个 函数 传递 某 些 代码 来 选择 函数 行为 。 
G16, MERA RA | 


代码 要 尽 可 能 具有 表达 力 。 联 排 表 达 式 、 匈牙利 语 标 记 法 和 魔术 数 都 这 项 了 作者 的 意图 。 
例如 ， 下 面 是 overTimePay 函数 可 能 的 一 种 表现 形式 : 


public int m otCalc() { 

return iThsWkd * iThsRte + 

(int) Math.round(0.5 * iThsRte * 
Math.max(0, iThsWkd - 400) 
); | 
) 


它 既 短小 又 紧凑 ， 但 实际 上 不 可 捉摸 。 值 得 花 时 间 将 代码 的 意图 呈现 给 读者 。 


G17: 位 置 错 误 的 权 责 


软件 开发 者 做 出 的 最 重要 决定 之 一 就 是 在 哪里 放 代 码 。 例 如 ，PI 常量 放 在 何 处 ?是 该 在 
Math 类 中 吗 ? 或 者 应 该 属于 Trigonometry 类 ? 还 是 在 Circle 类 ? 

最 小 惊异 原则 在 这 里 起 作用 了 。 代 码 应 该 放 在 读者 自然 而 然 期 待 它 所 在 的 地 方 。PI 常量 应 
该 在 出 现在 声明 三 角 函 数 的 地 方 。.OVERTIME RATE 常量 应 该 在 HourlyPayCalculator 类 中 声明 。 

有 时 ， 我 们 “聪明 ”地 知道 在 何 处 放置 功能 代码 。 我 们 会 放 在 自己 方便 而 读者 不 能 
直觉 找到 的 地 方 。 例如， 也 许 我 们 需要 打印 出 某 个 雇员 的 总 工作 时 间 的 报表 。 我们 可 以 在 
打印 报表 的 代码 中 做 工作 时 间 统 计 , 或 者 我 们 可 以 在 接受 工作 时 间 卡 的 代码 中 保留 一 份 工 
作 时 间 记 录 。 

做 这 个 决定 的 途径 之 一 是 看 函数 名 称 ， 比如 ， 报 表 模 块 有 个 名 为 getTotalHours 的 函数 。 
接受 时 间 卡 的 模块 有 一 个 saveTimeCard 函数 。 顾 名 思 义 ， 哪 个 名 称 暗 示 了 函数 会 计算 总 时 间 
We? 答案 显而易见 。 | 

显然 ， 对 于 总 时 间 应 该 在 接受 时 间 卡 的 时 候 计 算 而 不 是 在 打印 报表 时 计算 ， 这 里 面 有 些 
性 能 上 的 考量 。 没 问题 ， 但 函数 名 称 应 该 反映 这 种 考虑 。 例 如 ， 应 该 在 时 间 卡 模块 中 有 个 
computeRunningTotalOfHours 函数 。 


G18, 不 恰当 的 静态 方法 | 

Math.max(double a, double) 是 个 良好 的 静态 方法 。 它 并 不 在 单个 实体 上 操作 ， 的 确 ， 不 得 
不 写 new Math( ).max(a,b) 甚 至 amax(b) 实 在 思春 .那个 max 用 到 的 全 部 数据 来 自 其 两 个 参数 ， 
而 不 是 来 自 “ 所 属 ” 对 象 。 而 且 ， 我 们 也 没 机 会 用 到 Math.max 的 多 态 特征 。 

不 过 ， 我 们 有 时 也 编写 不 该 是 静态 的 静态 方法 。 例 如 : 

HourlyPayCalculator.calculatePay (employee, overtimeRate) . 


这 看 起 来 像 是 个 有 道理 的 static 函数 。 它 并 不 在 任何 特定 对 象 上 操作 ， 而 且 从 参数 中 获得 
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全 部 数据 。 然 而 ， 我 们 却 有 理由 希望 这 个 函数 是 多 态 的 。 我 们 可 能 希望 为 计算 每 小 时 支付 工资 
实现 几 种 不 同 算法 ， 例 如 OvertimeHourlyPayCalculator 和 StraightTimeHourlyPayCalculator。 所 
以 ， 在 这 种 情况 下 ， 该 函数 就 不 该 是 静态 的 。 它 该 是 Employee 的 非 静态 成 员 函 数 。 

通常 应 该 倾 网 于 选用 非 静 态 方 法 。 如 果 有 疑问 ， 就 是 用 非 静态 函数 。 如 果 的 确 需要 静态 
函数 ， 确 保 没 机 会 打算 让 它 有 多 态 行为 。 


G19. 使 用 解释 性 变量 


. Kent Beck 在 其 巨著 Smalltalk Best Practice Patterns' 和 另 一 部 巨著 Implementation Patterns 
(中 译 版 《实现 模式 》)“ 中 都 写 到 这 个 。 让 程序 可 读 的 最 有 力 方法 之 一 就 是 将 计算 过 程 打 散 
成 在 用 有 意义 的 单词 命名 的 变量 中 放置 的 中 间 值 。 

看 看 来 自 FitNesse 的 这 个 例子 : 


Matcher match = headerPattern.matcher (line); 
if (match. find() ) 
{ 
String key = match.group(1); 
String value = match.group (2) ; 
headers. put (key.toLowerCase(), value); 


解释 性 变量 的 这 种 简单 用 法 ， 说 明了 第 一 个 匹配 组 是 key， 而 第 二 个 匹配 组 是 value。 

这 事 很 难 做 过 火 。 解 释 性 变量 多 比 少 好 。 只 要 把 计算 过 程 打 散 成 一 系列 良好 命名 的 中 间 

不 透明 的 模块 就 会 突然 变 得 透明 ， 这 很 值得 注意 。 

G20: 图 数 名 称 应 该 表达 其 行为 

看 看 这 行 代码 : 

Date newDate = date.add(5); 

你 会 期 望 它 站 日 期 添加 5 天 吗 ? 或 者 是 5 个 星期 ? 5 个 小 时 ? 该 date 实体 会 变化 吗 ? 或 

者 该 函数 只 是 返回 一 个 新 的 Date 实体 ， 并 不 改动 旧 的 ? 从 函数 调用 中 看 不 出 函数 的 行为 。 
如 果 函 数 加 日 期 添加 $ 天 并 且 修 改 该 日 期 ， 就 该 命名 为 addDaysTo 或 increaseByDays. 

如 果 函 数 返 回 一 个 表示 $ 天 后 的 日 期 ， 而 不 修改 日 期 实体 ， 就 该 叫做 daysLater 或 daysSince。 
如 果 你 必须 查看 函数 的 实现 〈 或 文档 ) 才 知 道 它 是 做 什么 的 ， 就 该 换个 更 好 的 函数 名 ， 

或 者 重新 安排 功能 代码 ， 放 到 有 较 好 名 称 的 函数 中 。 


G21; 理解 算法 
好 多 可 笑 代 码 的 出 现 ， 是 因为 人 们 没 花 时 间 去 理解 算法 。 他 们 硬 塞 进 足够 多 的 证 语句 和 


m 


! 原 注 : [Beck97], : p. 108. 
? Rit: [Beck07]. 
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标识 ， 从 不 真正 停 下 来 考虑 发 生 了 什么 ， 勉 强 让 系统 能 工作 。 

编程 常常 是 一 种 探险 。 你 以 为 自己 知道 某 事 的 正确 算法 ， 然 后 就 卷 起 袖子 瞎 干 一 气 ， 搞 
到 “可 以 工作 ”为 止 。 你 怎么 知道 它 “ 可 以 工作 ”? 因为 它 通过 了 你 能 想到 的 单元 测试 。 这 
种 做 法 没 错 。 实 际 上 ， EE E 不 过 ,“ 可 以 工作 ” 周 
围 的 引号 可 不 能 一 直 保 留 。 

在 你 认为 自己 完成 某 个 函数 之 前 ， 确 认 自 己 理 解 了 它 是 怎 么 工作 的 。 通过 全 部 测试 还 不 
够 好 。 你 必须 知道 解决 方案 是 正确 的 。 

获得 这 种 知识 和 理解 的 最 好 途径 ， 往往 是 重 构 函数 ， 得 到 某 种 整洁 而 足 具 表达 力 、 清楚 

呈 示 如 何 工作 的 东西 。 


G22, 把 逻辑 依赖 改 为 物理 依赖 


如 果 某 个 模块 依赖 于 男 一 个 模块 ， 依 赖 就 该 是 物理 上 的 而 不 是 逻辑 上 的 。 依 赖 者 模块 不 
应 对 被 依赖 者 模块 有 假定 〈 换 言 之， 逻辑 依赖 )。 它 应 当 明 确 地 询问 后 者 全 部 信息 。 
例如 ， 想像 你 在 编写 一 个 打印 出 雇员 工作 时 长 的 纯 文 本 报表 的 函数 。 有 个 名 为 
HourlyReporter 的 类 把 数据 收集 为 某 种 方便 的 形式 ， 传 递 到 HourlyReportFormatter 中 ， 再 打 
印 出 来 。( 如 代码 清单 17-1 所 示 。) 


代码 清单 17-1 HourlyReporter java 


public class HourlyReporter { 
private HourlyReportFormatter formatter; 
private List<LineItem> page; 
private final int PAGE SIZE = 55; 


public HourlyReporter(HourlyReportFormatter formatter) { 
this.formatter = formatter; 
page = new ArrayList«LineItem»(); 

) 


public void generateReport (List<HourlyEmployee> employees) ( 
for (HourlyEmployee e : employees) ( 
addLineItemToPage (e); 
if (page.size() == PAGE SIZE) 
printAndClearItemList(); 
] 
if (page.size() > 0) 
printAndClearItemList(); 
) 


private void printAndClearItemList() ( 
formatter.format (page); 
page.clear(); 


” 原 注 ， 了 解 代码 如 何 工作 与 了 解 算法 是 否 按 需 要 执行 是 不 一 样 的 。 不 确定 算法 是 否 恰当 司空 见 惯 ， 而 不 确定 代码 做 什么 
却 是 一 种 懒惰 行为 。 
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} 


private void addLineItemToPage(HourlyEmployee e) { 
LineItem item = new LineItem(); 
item.name = e,getName(); 
item.hours = e.getTenthsWorked() / 10; 
| item.tenths = e.getTenthsWorked() % 10; 
page ,add (item); 
} 


| public class LineItem { 
public String name; 
. public int hours; 
public int tenths; 

} | | 
这 段 代 码 有 尚未 物理 化 的 逻辑 依赖 。 你 能 指出 来 吗 ? 那 就 是 常量 PAGE SIZE. 
HourlyReporter 为 什么 要 知道 页 面 尺 寸 ? 页 面 尺 寸 只 该 是 HourlyReportFormatter 的 权 责 。 

PAGE SIZE 在 HourlyReporter 中 声明 ， 代 表 了 一 种 位 置 错 误 的 权 责 [G17]， 导 致 
HourlyReporter 假定 它 知道 页 面 尺寸 。 这 类 假设 是 一 种 逻辑 依赖 。HourlyReporter 依赖 于 
HourlyReportFormatter 能 应 付 55 的 页 面 尺寸 。 如 果 HourlyReportFormatter 的 某 些 实现 不 能 处 
理 这 样 的 尺寸 ， 就 会 出 错 。 | 

可 以 通过 创建 HourlyReport 中 名 为 getMaxPageSize( ) 的 新 方法 来 物理 化 这 种 依赖 。 
HourlyReporter 将 调用 这 个 方法 ， 而 不 是 使 用 PAGE_SIZE 常量 。 


G23. MZAA |f/Else 或 Switch/Case ` 


有 了 第 6 章 谈 及 的 主题 ， 这 条 建议 看 似 奇怪 。 在 那 章 中 ， 我 提出 在 添加 新 函数 其 于 添加 
新 类 型 的 系统 中 ，switch 语句 是 恰当 的 。 

首先 ， 多 数 人 使 用 switch 语句 ， 因 为 它 是 最 直截了当 又 有 力 的 方案 ， 而 不 是 因为 它 适 合 
当前 情形 。 这 给 我 们 的 启发 是 在 使 用 switch 之 前 ， 先 考虑 使 用 多 态 。 

其 次 ， 函 数 变化 甚 于 类 型 变化 的 情形 相对 罕见 。 每 个 switch 语句 都 值得 怀疑 。 

我 使 用 所 谓 “ 单 个 switch” 规 则 ， 对 于 给 定 的 选择 类 型 ， 不 应 有 多 于 一 个 switch 语句 。 在 
那个 switch 语句 中 的 多 个 case， 必 须 创 建 多 态 对 象 ， 取 代 系 统 中 其 他 类 似 switch 语句 。 


G24: 遵循 标准 约定 


每 个 团队 都 应 遵循 基于 通用 行业 规范 的 一 套 编码 标准 。 编 码 标准 应 指定 诸如 在 何 处 声明 
实体 变量 ， 如 何 命名 类 ， 方 法 和 变量 ， 在 何 处 放置 括号 ， 等 等 。 团 队 不 应 用 文档 描述 这 些 约 
定 ， 因 为 代码 本 身 提供 了 范例 。 | 
” ”团队 中 的 每 个 成 员 都 应 遵循 这 些 约定 。 这 意味 着 每 个 团队 成 员 必须 成 熟 到 能 了 解 只 要 全 
体 同意 在 何 处 放置 括号 ， 那 么 在 哪里 放置 都 无 关 紧要 。 
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如 果 你 想 知道 我 遵循 哪些 约定 ， 可 以 查看 代码 清单 B-7~B-14 中 重 构 之 后 的 代码 。 


G25. 用 命名 常量 赫 代 魔术 数 


这 大 概 是 软件 开发 中 最 古老 的 规则 之 一 了 。 我 记得 ， 在 20 世纪 60 年 代 介绍 COBOL, 
FORTRAN 和 PL/1 的 手册 中 就 读 到 过 。 在 代码 中 出 现 原始 形态 数字 通常 来 说 是 坏 现象 。 应 该 
用 良好 命名 的 常量 来 隐藏 它 。 " 

例如 ,数字 86400 应 当 藏 在 常量 SECONDS PER. DAY 后 面 。 如 果 每 页 打印 55 47, 则 常 
数 55 应 该 藏 在 常量 LINES_PER_PAGE 后 面 。 

”有 些 常量 与 非常 具有 自我 解释 能 力 的 代码 协同 工作 时 ， 如 此 易于 识别 ， 也 就 不 必 总 是 需 
要 命名 常量 来 隐藏 了 。 例 如 ， BEN 


double milesWalked = feetWalked/5280.0; 
int dailyPay = hourlyRate * 8; 
double circumference - radius * Math.PI * 2; 


在 上 例 中 , Re ZA E FEET. PER. MILE. WORK, HOURS DER DAY 和 TWO 吗 ? 
显然 ， 最 后 那个 很 可 笑 。 有 些 情况 下 ， 常 量 直 接 写 作 原 始 形态 数字 会 更 好 。 你 可 能 会 质疑 
WORK_HOURS_PER_DAY， 因 为 约定 规则 可 能 会 改变 。 另 一 方面 ， 在 这 里 直接 用 数字 8 读 
起 来 很 舒服 , 也 就 没 必 要 非 用 17 个 额外 的 字母 来 加 重读 者 负担 不 可 .对 于 FEET_PER_MILE, 
数字 5280 众人 丝 知 ， 意 义 独 特 ， 即 便 没有 上 下 文 环境 ， 读 者 也 能 识别 它 。 

3.141592653589793 之 类 常数 也 众所周知 ， 很 容易 识别 。 不 过 ， 如 果 直 接 使 用 原始 形式 ,… 
却 很 有 可 能 出 错 。 每 次 有 人 看 到 3.141592653589793, 30-2: 138 JEJE x 值 ， 从 而 不 会 去 仔细 查 
看 。( 你 发 现 那个 错误 的 数字 了 吗 ? ) 我 们 不 想 要 人 们 使 用 3.14、3.14159 或 3.142 等 。 所 以 ， 
为 我 们 定义 好 Math.PI 是 件 好 事 。 | 

术语 “魔术 数 ” 不 仅 是 说 数字 。 它 泛 指 任何 不 能 自我 描述 的 符号 。 例 如 : 

. assertEquals(7777, Employee.find("John Doe").employeeNumber()); ; 
上 列 断 言 中 有 两 个 魔术 数 。 第 一 个 显然 是 777, 它 的 意义 并 不 明确 ,第 二 个 魔术 数 是 John 
Doe， 因 为 其 意图 不 明显 。 | 

John Doe 是 开发 团队 创建 的 测试 数据 中 编号 为 上 777 的 雇员 。 团 队 中 每 个 成 员 都 知道 ， 
当 连 接 到 数据 库 时 ， 里 面 已 经 有 数 个 雇员 信息 ， 其 值 和 属性 都 是 大 家 熟知 的 。 所 以 ， 这 个 测 
试 应 该 读 作 : 


assertEquals ( 
HOURLY EMPLOYEE ID, 
Employee. find (HOURLY EMPLOYEE NAME). employeeNumber ()) ; 


G26: 准确 | 
SABE TE TE eg ALERE — UG BG RT RB TARA. FH RR IB JURE AO 
3E. ALARA AE ASE JC TB E / 0X3 45 E Eh te WC IDA. YES 
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可 以 用 List 的 时 候 非 要 把 变量 声明 为 ArrayList 就 过 分 拘束 了 。 把 所 有 变量 设置 为 protected 
AU ER. 

在 代码 中 做 决定 时 ， 确 认 自 己 足 够 准确 。 明确 自己 为 何 要 这 么 做 ， 如 果 过 到 异常 情况 如 何 
处 理 。 别 懒得 理会 决定 的 准确 性 。 如 果 你 打算 调用 可 能 返回 null 的 函数 ， 确 认 自 己 检 查 了 null 
值 。 如 果 查 询 你 认为 是 数据 库 中 唯一 的 记录 ， 确 保 代 码 检 查 不 存在 其 他 记录 。 如 果 要 处 理 货 币 
数据 ,使 用 整数 '.， 并 恰当 地 处 理 四 合 五 入 。 如 果 可 能 有 并 发 更 新 , 确认 你 实现 了 某 种 锁定 机 制 。 

代码 中 的 含糊 和 不 准确 要 么 是 意见 不 同 的 结果 , 要 么 源 于 懒惰 。 无 论 原因 是 什么 , 都 要 消除 。 


G27: 结构 其 于 约定 | 

坚守 结构 其 于 约定 的 设计 决策 。 命 名 约定 很 好 ， 但 却 次 于 强制 性 的 结构 。 例 如 ， 用 到 民 
好 命名 的 枚 举 的 switch/case 要 弱 于 拥有 抽象 方法 的 基 类 。 没 人 会 被 强迫 每 次 都 以 同样 方式 实 
现 switch/case 语句 ， 但 基 类 却 让 具体 类 必须 实现 所 有 抽象 方法 。 

G28: 封装 条 件 


如 果 没有 if while 语句 的 上 下 文 ， 布 尔 逻辑 就 难以 理解 。 应 该 把 解释 了 条 件 意 加 的 函 一 
数 抽 离 出 来 。 | 
例如 : 


if (shouldBeDeleted (timer)) 


要 好 于 


if (timer.hasExpired() && !timer.isRecurrent ()) 


G29. 避免 否定 性 条 件 | 
否定 式 要 比 肯定 式 难 明 白 一 些 。 所 以 ， 尽 可 能 将 条 件 表示 为 肯定 形式 。 例 如 : 


if (buffer.shouldCompact ()) 


要 好 于 


if (!buffer.shouldNotCompact () ) 


G30: 函数 只 该 做 一 件 事 


: 编写 执行 一 系列 操作 的 包括 多 段 代码 的 函数 党 常 是 诱 人 的 。 这 类 函数 做 了 不 只 一 件 事 ， 
， 应 该 转换 为 多 个 更 小 的 函数 ， 每 个 只 做 一 件 事 。 | 
: 例如 : 


public void pay() { 


` pr, 或 者 用 更 好 的 使 用 整数 的 Money 28. 
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for (Employee e : employees) ( 
if (e.isPayday()) ( 
Money pay = e.calculatePay(); 
e.deliverPay (pay); 
) 
" 
) 


这 段 代码 做 了 三 件 事 。 COATT mA, 检查 是 否 该 给 雇员 付 工资 ， Enge, 代 
码 可 以 写 得 更 好 ， 如 : 


public void pay() { 
for (Employee e : employees) 
payIfNecessary (e); 
} | 


private void payIfNecessary(Employee e) { 
if (e.isPayday()) 
calculateAndDeliverPay (e); 
) 


private void calculateAndDeliverPay (Employee e) { 
Money pay = e.calculatePay(); 
e.deliverPay(pay); 

) 


上 列 每 个 函数 都 只 做 一 件 事 。( 见 前 文 “ 只 做 一 件 事 ”一 节 。) 
1: 掩蔽 时 序 耦合 


常常 有 必要 使 用 时 序 看 合 ， 但 你 不 应 该 掩蔽 它 。 排 列 函 数 参数 ， 好 让 它们 被 调用 的 次 序 ， 
显而易见 。 看 下 列 代码 : | 3 


public class MoogDiver [- | E 
Gradient gradient; | P 
List<Spline> splines; 


public void dive(String reason) { 
saturateGradient(); d 
reticulateSplines(); 3 
diveForMoog (reason); ` 


E | 
三 个 函数 的 次 序 很 重要 。 捕 鱼 之 前 先 织 网 ， 织 网 之 前 先 编 绳 。 不 幸 的 是 ， 代 码 并 没有 强 3 


制 这 种 时 序 耦 合 。 其 他 程序 员 可 以 在 调用 saturateGradient 之 前 调用 reticulateSplines， 从 而 导 € 
致 抛 出 UnsaturatedGradientException 异常 。 更 好 的 方式 是 : à 


public class MoogDiver { 
Gradient gradient; 
List<Spline> splines; 
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public void dive(String reason) { 
Gradient gradient = saturateGradient(); 
List<Spline> splines = reticulateSplines (gradient); 
diveForMoog(splines, reason); 


) 


) | 

这 样 就 通过 创建 顺序 队列 暴露 了 时 序 耦合 。 每 个 函数 都 产生 出 下 一 个 函数 所 需 的 结果 ， 
这 样 一 来 就 没 理由 不 按 顺序 调用 了 。 

你 可 能 会 抱 忽 着 增加 了 函数 的 复杂 度 ， 没 错 ， 不 过 这 点 额外 的 复杂 度 却 阳 露 了 该 种 情况 
真正 的 时 序 复杂 性 。 

注意 我 保留 了 那些 实体 变量 。 我 假设 类 中 的 私有 方法 可 能 会 用 到 它们 。 即 便 如 此 ， 我 还 
是 希望 参数 能 让 时 序 耦 合 变 得 可 见 。 


G32, BIBER 


构建 代码 需要 理由 ， 而 且 理由 应 与 代码 结构 相 契 合 。 如 果 结 构 显得 太 随 意 ， 其 他 人 就 会 
想 修改 它 。 如 果 结 构 自始至终 保持 一 致 ， 其 他 人 就 会 使 用 它 ， 并 且 遵 循 其 约定 。 例 如 ， 我 最 
XL FitNesse 做 合并 修改 ， 发 现 有 位 贡献 者 这 么 做 : 


public class AliasLinkWidget extends ParentWidget 


{ 
public static class VariableExpandingWidgetRoot { 


} 

问题 在 于 ,VariableExpandingWidgetRoot 没 必要 在 AliasLinkWidget 作用 范围 之 内 。 而 且 ， 
其 他 无 关 的 类 也 用 到 AliasLinkWidget.VariableExpandingWidgetRoot。 这 些 类 没 » 要 了 解 
AliasLinkWidget。 | | 

或 许 那 位 程序 员 只 是 循 例 把 VariableExpandingWidgetRoot 放 到 AliasWidget Hi, RA 
他 真 认为 这 么 做 是 对 的 。 不 管 原因 是 什么 ， 结 果 都 显得 随心 所 欲 。 不 作为 类 工具 的 公共 类 ， 
不 应 该 放 到 其 他 类 里 面 。 惯 例 是 将 它 置 为 public， 并 且 放 在 代码 包 的 顶部 。 


G33. 封装 边界 条 件 


边界 条 件 难以 追踪 。 把 处 理 边界 条 件 的 代码 集中 到 一 处 ， 不 要 散落 于 代码 中 。 我 们 不 想 
见 到 四 处 散 见 的 +1 和 一 1 字样 。 看 看 这 个 来 自 FIT 的 简单 例子 : 


if (level + 1 < tags.length) 
{ | 
parts = new Parse(body, tags, level + 1, offset + endTag); 
body = null; 
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) | 
注意 , level + 1 出 现 了 两 次 。 这 是 个 应 该 封装 到 名 为 nextLevel 之 类 的 变量 中 的 边界 条 件 。 


int nextLevel = level + 1; 

if(nextLevel < tags.length) 

{ 

parts = new Parse(body, tags, nextLevel, offset + endTag); 
body = null; 


G34; 函数 应 该 只 在 一 个 抽象 层级 上 


函数 中 的 语句 应 该 在 同一 抽象 层级 上 ， 该 层级 应 该 是 函数 名 所 示 操 作 的 下 一 层 。 这 可 能 
是 最 难 理解 和 遵循 的 启发 。 尽 管 概念 足够 直 白 ， 人 们 还 是 很 容易 混淆 抽象 层级 。 例 如 ， 请 看 
下 面 来 自 FitNesse 的 例子 : 


public String render() throws Exception 
{ 
StringBuffer html = new StringBuffer ("<hr"); 
if(size > 0) 
html.append(" size=\"") .append(size + 1) .append("\""); 
html.append (">"); 


return html.toString(); 
} 


稍微 研究 一 下 , 你 就 会 看 到 发 生 了 什么 。 该 函数 构建 了 绘制 横贯 页 面 线条 的 HTML 标记 。 
线条 高 度 在 size 变量 中 指定 。 

再 看 一 遍 。 方 法 混杂 了 至 少 两 个 抽象 层级 。 第 一 个 是 横 线 有 尺寸 这 个 概念 。 第 二 个 是 hr 
标记 自身 的 语法 。 这 段 代 码 来 自 FitNesse 的 HruleWidget 模块 。 该 模块 检测 一 行 4 个 或 更 多 
个 破 折 号 ， 并 将 其 转换 为 恰当 的 hr 标记 。 破 折 号 越 多 ， 尺 寸 越 大 。 

我 重 构 了 这 段 代 码 。 注 意 ， 我 修改 了 size 字段 的 名 称 ， 反映 其 真正 目的 。 它 表示 额外 破 
折 号 的 数量 。 


public String render() throws Exception 


HtmlTag hr = new HtmlTag("hr"); 
if (extraDashes > 0) 
hr.addAttribute ("size", hrSize(extraDashes)); 
return hr.html(); 
) 


private String hrSize(int height) 
{ | 
int hrSize = height + 1; 
return String, format ("%d", hrSize); 


) 
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这 次 修改 很 好 地 拆 开 了 两 个 抽象 层级 。 函 数 render 只 构造 一 个 hr 标记 , 不 NERA 
HTML 语法 。 而 HtmlTag TAA JU Fa E ATA bn BE ESI TE S [e] RB 

做 出 修改 时 ， 我 发 现 了 一 处 微小 的 错误 。 原始 代码 没有 加 上 hr 标记 的 结束 斜 线 符 ， 而 
XHTML 标准 要 求 这 样 做 。( 换 言 之 ， ae 了 <hr> 而 不 是 <hr />.) HtmlTag 模块 很 早 就 改 
造成 符合 XHTML 标准 了 。 

拆 分 不 同 抽象 层级 是 重 构 的 最 重要 功能 之 一 ， 也 是 最 难 做 的 一 个 。 以 下 面 的 代码 为 例 。 
这 是 我 第 一 次 党 试 拆 分 HruleWidget.rendermethod 中 iam 的 结果 。 


public String render() throws Exception 


HtmlTag hr - new HtmlTag("hr"); 

if (size > O) ( | 
hr.addAttribute("size", ""+(sizetl)); 

| 

return hr.html(); 

) 


此 时 , 我 的 目的 是 做 必要 的 拆 分 ， 并 让 测试 通过 。 我 轻易 达到 了 这 一 目的 , 但 结果 是 
该 函数 仍然 混杂 了 多 个 抽象 层级 。 此 时 ,混杂 的 层级 是 hr 标记 的 构建 ， 以 及 size 变量 的 
翻译 和 格式 化 。 这 说 明 当 你 任 抽 和 象 界线 拆 解 函数 时 , 经 常会 挖 出 原本 被 之 前 的 结构 所 掩蔽 
的 新 抽象 界线 。 


G35; 在 较 高 层级 放置 可 配置 数据 


如 果 你 有 个 已 知 并 该 在 较 高 抽象 层级 的 默认 常量 或 配置 值 , 不 要 将 它 埋 藏 到 较 低层 级 
的 函数 中 。 把 它 作 为 较 高 层级 函数 调用 较 低 层级 函数 时 的 一 个 参数 。 看 看 以 下 来 自 
FItNesse 的 代码 : 


public static void main(String[] args) throws Exception 
Arguments arguments = parseCommandLine (args); 
} 


public class Arguments 
{ 
public static final String DEFAULT PATH = "."; 
public static final String DEFAULT ROOT = "FitNesseRoot"; 
public static final int DEFAULT PORT - 80; 
dx Static final int DEFAULT VERSION DAYS - 14; 


) 


命 信行 参数 在 FitNesse 中 的 第 一 行 可 执行 代码 得 到 解析 。 这 些 参数 的 默认 值 在 Argument 
类 的 顶部 指定 。 你 不 必 到 系统 的 较 低 层级 去 查看 类 似 的 语句 : 


if (arguments.port == 0) // use 80 by default 
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位 于 较 高 层级 的 配置 性 常量 易于 修改 。 它 们 向 下 贯穿 应 用 程序 。 ROAR RE 1 
TETA RS. 1 


G36, 避免 传递 浏览 


通常 我 们 不 想 让 某 个 模块 了 解 太 多 其 协作 者 的 信息 。 更 具体 地 说 ， 如 果 A 与 B 协 作 ，B 3 

5 C 协作 ， 我 们 不 想 让 使 用 A 的 模块 了 解 C 的 信息 。( 例 如 ， 我 们 不 想 写 类 似 f 
a.getB().getC( ).doSomethingOR MB.) : E 
XR TIR AE. The Pragmatic Programmers (中 译 版 《程序 员 修炼 之 道 》) 称 之 为 ， 1 
“编写 害 着 代码 ”`。 两 者 都 归结 为 确保 模块 只 了 解 其 直接 协作 者 ， 不 了 解 整个 系统 的 游览 图 。 -3 
如果 有 多 个 模块 使 用 类 似 a.getB().getC() 这 样 的 语句 形式 ， 就 难以 修改 设计 和 架构 ， 在 B 和 3 
C 之 间 插 进 一 个 Q。 你 得 找到 a.getB().getC() 出 现 的 所 有 地 方 , 并 将 其 改 为 a.getB().getQ().getC()。 
系统 就 此 变 得 缺乏 柔韧 性 。 太 多 的 模块 了 解 了 太 多 有 关 架 构 的 信息 。 : 
IER E CAE VE EEBEUME 2E RET NS RS. ROEBRANMAS EA, BIRI 4 

要 调用 的 方法 。 只 要 简单 地 说 : | 


myCollaborator.doSomething(). 





EE TER 
Ai AA SN TS 


17.5 Java | a 


J1， 通过 使 用 通配符 各 免 过 长 的 导入 清音 

如 果 使 用 了 来 自 同一 程序 包 的 两 个 或 多 个 类 ， 用 以 下 语句 导入 整个 包 ，: 

import package.*; 

过 长 的 导入 清单 令 读 者 望而却步 。 我 们 不 想 用 80 行 导 入 语句 搞 乱 模块 顶部 位 置 。 我们 想 
要 导入 语句 简约 地 列 出 我 们 要 使 用 的 包 。 

指定 导入 包 是 种 硬 依赖 ， 而 通配符 导入 则 不 是 。 如 果 你 具体 指定 导入 某 个 类 ， 该 类 必须 
存在 。 但 如 果 你 用 通配符 导入 某 个 包 ， 则 不 需要 存在 具体 的 类 。 导 入 语句 只 是 在 搜寻 名 称 时 
把 这 个 包 列 入 查找 路 径 。 所 以 ， 这 种 导入 并 未 构成 真正 的 依赖 ， 也 就 让 我 们 的 模块 较 少 耦合 。 

有 时， 长 长 的 具体 导入 清单 也 会 有 用 。 例 如 ， 如 果 你 在 处 理 遗 留 下 来 的 代码 ， 想 要 
找 出 需要 为 哪些 类 构造 替身 类 和 占 位 代码 ， 就 可 以 裔 历 导 入 清单 ， 找 出 这 些 类 的 真名 —— 
再 恰当 地 放置 占 位 代码 。 不 过 ， 这 种 用 法 很 罕见 。 而 且 ， 多 数 现代 IDE 允许 你 用 一 个 命 
令 就 把 通配符 导入 语句 转换 为 指定 导入 清单 。 所 以 ， 即便 在 处 理 遗 留 代码 时 ， 最 好 也 用 


' 原 注 ，[PRAG]，P 138。 
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通配符 导入 。 
通配符 导入 有 时 会 导致 名 称 冲 突 和 歧义 。 两 个 同名 但 位 于 不 同 包 中 的 类 需要 指名 导入 ， 


或 至 少 在 使 用 时 指定 名 称 。 这 种 情形 的 确 讨 厌 ， 不 过 很 罕见 ， 所 以 使 用 通配符 导入 通常 仍 优 
于 指定 名 称 导 入 。 


J2. 不 要 继承 常量 


我 见 过 这 种 情况 好 几 次 ， 它 总 是 让 我 而 吉首 笑 。 某 个 程序 在 接口 中 放 了 些 常量 ， 再 通过 
继承 结构 来 访问 这 些 常量 。 看 看 以 下 代码 ， | 


public class HourlyEmployee extends Employee { 
private int tenthsWorked; 
private double hourlyRate; 


public Money calculatePay() { | 
int straightTime - Math.min(tenthsWorked, TENTHS PER WEEK); T 


int overTime = tenthsWorked - straightTime; 


return new Money( 
hourlyRate * (tenthsWorked * OVERTIME RATE * overTime) 


3 
} 


} 
常量 TENTHS_PER_WEEK 和 OVERTIME_RATE 来 自 何方 ? 它们 可 能 来 自 Employee 类 。 


来 看 看 : 


public abstract class Employee implements PayrollConstants { 
public abstract boolean isPayday(); 
public abstract Money calculatePay(); 
public abstract void deliverPay(Money pay); 


) 
不 ， 不 在 那儿 。 不 过 在 哪儿 昵 ? 再 仔细 看 Employee 类 。 它 实现 了 PayrollConstants 接口 。 


public interface PayrollConstants | 
public static final int TENTHS PER WEEK = 400; 
SE static final double OVERTIME RATE = 1.5; 


SHE! 常量 租 在 了 继承 结构 的 最 顶端 PRI 别 利用 继承 欺骗 编程 语言 的 作用 范 
围 规则 。 应 该 用 静态 导入 。 


import static PayrollConstants.*; 


public class HourlyEmployee extends | dccus ( 
private int tenthsWorked; 
private double hourlyRate; 


public Money calculatePay() { 
int straightTime = Math.min(tenthsWorked, TENTHS, PER WEEK); 


int overTime - tenthsWorked - straightTime; 
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return.new Money( 
hourlyRate * (tenthsWorked * OVERTIME RATE * overTime) 

); l 

} 


) 


J3: 常量 vs. POR 


现在 enum 已 经 加 入 Java 语言 (Java 5)， 放 心 用 吧 ! 别 再 用 那个 public static final int 老 
花招 。 那 样 做 int 的 意义 就 丧失 了 ， 而 用 enum 则 不 然 ， 因 为 它们 隶属 于 有 名 称 的 枚 举 。 

而 且 ， 仔 细 研 究 enum 的 语法 。 它 可 以 拥有 方法 和 字段 ， 从 而 成 为 能 比 int 提供 更 多 表达 
力 和 灵活 性 的 强 有 力 工具 。 看 看 以 下 发 薪 代 码 中 的 不 同 做 法 : — , 


public class HourlyEmployee extends Employee ( 
private int tenthsWorked; 
HourlyPayGrade grade; 


public Money calculatePay() ( 
int straightTime - Math.min(tenthsWorked, TENTHS PER WEEK); 
int overTime = tenthsWorked - straightTime; 
return new Money( 
grade.rate() * (tenthsWorked * OVERTIME RATE * overTime) 
); 
) 


) 


public enum HourlyPayGrade { 
APPRENTICE { 
public double rate() { 
return 1.0; 
) 
by 
LEUTENANT JOURNEYMAN { 
public double rate() { 
return 1.2; 
) 
), 
JOURNEYMAN ( 
public double rate() ( 
return 1.5; 
) 
), 
MASTER { 
public double rate() { 
return 2.0; 
) 
bi 


public abstract double rate(); 
) 
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17.6 名称 


N1: 采用 描述 性 名 称 


不 要 太 快 取 名 。 确认 名 称 具有 描述 性 。 记 住 ， 事物 的 意义 随 着 软件 的 演化 而 变化 ， 所 以 ， 
要 经 常 性 地 重新 估量 名 称 是 否 恰当 。 m 

这 不 仅 是 一 条 “感觉 良好 式 ” 建 议 。 软 件 中 的 名 称 对 于 软件 可 读 性 有 90% 的 作用 。 你 要 
花 时 间 明 智 地 取 名 ， 保 持 名 称 有 关 。 名 称 太 重要 了 ， 不 可 随意 对 待 。 

看 看 以 下 代码 。 这 段 代码 是 做 什么 的 ? 用 了 好 名 称 的 代码 一 目 了 然 ， 而 这 样 的 代码 却 是 
符号 和 魔术 数 的 大 杂烩 。 


public int x() { 
int q = 0; 
int z = 0; 
for (int kk = 0; kk < 10; kktt) { 
if qp == 10) 
{ 
q t= 10 + (l[z + 1] + l[z + 2]); 
z += 1; 
} 
else if (l[z] + l[z + 1] == 10) 
{ 
q += 10 + l[z + 2]; 
z += 2; 
} else { 
q += l[z] + l[z + 1]; 
Z += 2; 
} 
} 


return q; 


下 面 是 这 段 代 码 应 该 写成 的 样子 。 代 码 片段 实际 上 不 如 上 段 完整 。 但 你 还 是 能 马上 推断 
出 它 要 做 什么 ， 而 且 很 有 可 能 依据 推断 出 的 意思 写 出 遗漏 的 函数 。 魔 术 数 不 复 神秘 ， 算 法 的 
结构 也 足 具 描述 性 。 


public int Score () { 
int score = 0; 
int frame = 0; 
for (int frameNumber = 0; frameNumber < 10; frameNumber44) ( 
if (isStrike(frame)) ( 
score += 10 + EE 
frame += 1; 
) else if (isSpare(frame)) ( 
Score += 10 + nextBallForSpare (frame); 
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frame += 2; 
) else ( 
score += twoBallsInFrame (frame); 
frame += 2; 
) 
) 


return score; 


仔细 取 好 的 名 称 的 威力 在 于 ， 它 用 描述 性 信息 履 益 了 代码 。 这 种 信息 窗 盖 设 定 了 读者 对 
于 模块 中 其 他 函数 行为 的 期 待 .看 看 上 面 的 代码 , 你 就 能 推断 出 isStrike( ) 的 实现 。 读 到 isStrick 
方法 时 ， 它 “ 深 合 你 意 ”1。 

private boolean isStrike(int frame) { 


return rolls[frame] == 10; 
) 


N2: 名 称 应 与 抽象 层级 相符 


不 要 取 沟 通 实现 的 名 称 ， 取 反映 类 或 函数 抽象 层级 的 名 称 。 这 样 做 不 容易 。 人 们 擅长 于 
混杂 抽象 层级 。 每 次 浏览 代码 ， 你 总 会 发 现 有 些 变量 的 名 称 层级 太 低 。 你 应 当 趁 机 为 之 改名 。 
要 让 代码 可 读 ， 需 要 持续 不 断 的 改进 。 看 看 下 面 的 Modem 接口 : 


public interface Modem { 
boolean dial(String phoneNumber); 
boolean disconnect (); 
boolean send(char c); 
char recv(); 
String getConnectedPhoneNumber () ; 
} 


粗 看 还 行 。 函 数 看 来 都 很 合适 ， 对 于 多 数 应 用 程序 来 说 是 这 样 。 不 过 ， 想 想 看 某 个 应 用 
中 有 些 调制 解 调 器 并 不 用 拨号 连接 的 情形 。 有 些 用 线 缆 直 连 《〈 就 像 如 今 为 多 数 家 庭 提 供 
Internet 连接 的 线 费 解 调 器 ) WTB. AI USB ORO eR. SS, ARE 
话 号 码 的 信息 就 是 位 于 错误 的 抽象 层级 了 。 对 于 这 种 情形 ， 更 好 的 命名 策略 可 能 是 : 


public interface Modem { 
boolean connect (String connectionLocator); 
boolean disconnect(); 
boolean send(char c); 
char recv(); 
String getConnectedLocator(); 


现在 名 称 再 不 与 电话 号 码 有 关系 。 还 是 可 以 用 于 用 电话 号 码 的 情形 ， 也 可 以 用 于 其 他 连 
接 策略 。 : 


' 原 注 ， 见 第 一 章 中 Ward Cunningham 的 引 语 。 
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: 尽 可 能 使 用 标准 命名 法 


如 果 名 称 基于 既 存 约定 或 用 法 ， 就 比较 易于 理解 。 例如 ， 如 果 你 采用 油漆 工 模式 ， 就 该 
在 给 油漆 类 命名 时 用 上 Decorator 字样 。 例 如 ，AutoHangupModemDecorator 可 能 是 某 个 给 
Modem 类 刷 上 在 会 话 结束 时 自动 挂机 的 能 力 的 类 的 名 称 。 

“模式 只 是 标准 的 一 种 ,例如 , 在 Java 中 ， 将 对 象 转换 为 字符 趾 的 函数 通常 命名 为 toString。 

最 好 是 遵循 这 些 约定 ， 而 不 是 自己 创造 命名 法 。 | 

对 于 特定 项 目 ， 开 发 团队 常常 发 明 上 自己 的 命名 标准 系统 。Eric Evans 称 之 为 项 的 共同 
语言 '。 代 码 应 该 使 用 来 自 这 种 语言 的 术语 。 简 言 之 ， 具有 与 项 目 有 关 的 特定 意义 的 名 称 用 得 
越 多 ， 读 者 就 越 容易 明白 你 的 代码 是 做 什么 的 。 


N4; 无 歧义 的 名 称 
选用 不 会 混淆 函数 或 变量 意义 的 名 称 。 看 看 来 自 FitNesse 的 这 个 例子 : 


private String doRename() throws Exception 
( 
if(refactorReferences) 
renameReferences(); 
renamePage(); 


pathToRename. removeNameFromEnd () ; 
pathToRename.addNameToEnd (newName) ; 
return PathParser.render (pathToRename); 


) 


该 函数 的 名 称 含混 不 清 ， 没 有 说 明 函 数 的 作用 。 由 于 在 doRename 函数 里 面 还 有 个 名 为 
renamePage 的 函数 ， 这 就 更 不 明白 了 ! 这 些 名 称 有 没有 说 明 两 个 函数 之 间 的 区 别 昵 ? WH. 

该 函数 的 更 好 名 称 应 该 是 renamePageAndOptionallyAllReferences。 看 似 太 长 ， 的 确 也 很 
长 ， 不 过 它 只 在 模块 中 的 一 处 被 调用 ， 所 以 其 解释 性 的 好 处 大 过 了 长 度 的 坏处 。 


N5: 为 较 大 作用 范围 选用 较 长 名 称 


名 称 的 长 度 应 与 作用 范围 的 广泛 度 相 关 。 对 于 较 小 的 作用 范围 ， 可 以 用 很 短 的 名 称 ， 而 
”对 于 较 大 作用 范围 就 该 用 较 长 的 名 称 。 

类 似 i 和 j 之 类 的 变量 名 对 于 作用 范围 在 5 行 之 内 的 情形 没 问 题 。 看 看 以 下 来 自 老 “ 标 
准 保龄球 游戏 ”的 代码 片段 : 


private void rollMany (int n, int pins) 
, | 
for (int i20; i<n; i++) 
g.roll(pins); 
) 


' 原 注 : [DDD]。 
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这 段 代码 很 明白 ， 如 果 用 rollCount 之 类 烦人 的 名 称 代替 变量 i， 反 而 是 徒 增 混乱 。 男 一 
方面 ， 在 较 长 距离 上 ， 使 用 短 名 称 的 变量 和 男 数 会 克 失 其 含义 ， 名 称 的 作用 范围 越 大 ， 名 称 


”就 该 越 长 、 越 准确 。 


N6: Soen 
不 应 在 名 称 中 包括 类 型 或 作用 范围 信息 。 在 如 今 的 开发 环境 中 ，m 或 之 类 前 级 完全 无 


用 。 类 似 vis (表示 图 形 系统 ) 之 类 的 项 目 或 子 系统 名 称 也 属 多 余 。 当 今 的 开发 环境 不 用 纠 
强 于 名 称 也 能 提供 这 些 信息 。 不 要 用 匈牙利 语 命名 法 污染 你 的 名 称 。 
Ni, 名 称 应 该 说 明 副作用 — 
名称 应 该 说 明 函 数 、 变 量 或 类 的 一 切 信息 。 不 要 用 名 称 挤 项 副作用 。 不 要 用 简单 的 动词 
来 描述 做 了 不 止 一 个 简单 动作 的 函数 。 例 如 ， 请 看 以 下 来 自 TestNG 的 代码 : 
public ObjectOutputStream getOos () throws IOException { 
if (m oos == null) { 


m oos = new ObjectOutputStream(m socket.getOutputStream()); 
) 


return m ooS; 


) 


该 函数 不 只 是 获取 一 个 oos, WR oos 不 存在 ， 还 会 创建 一 个 。 所 以 ， 更 好 的 名 称 大 概 
是 createOrReturnOos. 


17.7 测试 


: 测试 不 足 

一 套 测试 中 应 该 有 多 少 个 测试 ? 不 幸 的 是 , 许多 程序 员 的 衡量 标准 是 “看 起 来 够 了 ”。 一 
套 测试 应 该 测 到 所 有 可 能 失败 的 东西 。 只 要 还 有 没 被 测试 探测 过 的 条 件 ， 或 是 还 有 没 被 验证 
过 的 计算 ， 测 试 就 还 不 够 。 a 

T2. 使 用 覆盖 率 工具 

覆盖 率 工具 能 汇报 你 测试 策略 中 的 缺口 。 使 用 覆盖 率 工 具 能 更 容易 地 找到 测试 不 足 的 模 
块 、 类 和 函数 。 多 数 IDE 都 给 出 直观 的 指示 ， 用 绿色 标记 测试 覆盖 了 的 代码 行 ， 而 未 覆盖 的 
代码 行 则 是 红色 。 这 样 就 能 又 快 又 容易 地 找到 尚未 检测 过 的 if BY catch 语句 。 

T3， 别 略 过 小 测试 : 

小 测试 易于 编写 ， 其 文档 上 的 价值 高 于 编写 成 本 。 
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T4: 被 忽略 的 测试 就 是 对 不 确定 事物 的 疑问 


有 了 时， 我 们 会 因为 需求 不 明 而 不 能 确定 某 个 行为 细节 。 可 以 用 注释 掉 的 测试 或 者 用 
@Ignore 标记 的 测试 来 表达 我 们 对 于 第 求 的 疑问 。 使 用 哪 种 方式 ， 取 决 于 该 不 确定 性 所 关 涉 
代码 是 否 要 编译 。 


T5. 测试 边界 条 件 | 
特别 注意 测试 边界 条 件 。 算 法 的 中 间 部 分 正确 但 边界 判断 错误 的 情形 很 常见 
T6. 全 面 测试 相近 的 缺陷 


缺陷 趋向 于 扎堆 。 RCRA NREN, RAE AAR, 你 可 能 AR 
现 缺 陷 不 止 一 个 。 


T7; 测试 失败 的 模式 有 启发 性 


有 了 时， 你 可 以 通过 找到 测试 用 例 失 败 的 模式 来 诊断 问题 所 在 。 这 也 是 尽 可 能 编写 足够 完 
整 的 测试 用 例 的 理由 之 一 。 完 整 的 测试 用 例 ， 按 合理 的 顺序 排列 ， 能 暴露 出 模式 。 

简单 举例 ， 假 设 你 注意 到 所 有 长 于 5 个 字符 的 输入 都 会 导致 测试 失败 ， 或 者 向 函数 的 第 
二 个 参数 传 入 负数 都 会 导致 测试 失败 。 有 时 ， 只 要 看 看 测试 报告 的 红 绿 模式 ， 就 足以 绽放 出 
那 句 带 来 解决 方法 的 “ 啊 哈 !” 回 头 看 看 第 16 章 “ 重 构 SerialDate” 中 的 有 趣 例子 吧 。 


T8, 测试 覆盖 率 的 模式 有 启发 性 
查看 被 或 未 被 已 通过 的 测试 执行 的 代码 ， 往 往 能 发 现 失败 的 测试 为 何 失败 的 线索 。 
T9: 测试 应 该 快速 


慢 速 的 测试 是 不 会 被 运行 的 测试 。 时 间 一 紧 ， 较 慢 的 测试 就 会 被 摘 掉 。 所 以 ， 竭 尽 所 能 
让 测试 够 快 。 


17.8 ”小结 


这 份 局 发 与 味道 的 清单 很 难说 已 完备 无 缺 。 我 不 能 确定 这 样 一 份 清单 会 不 会 完备 无 缺 。 
但 或 许 完 整 性 不 该 是 目标 ， 因 为 该 清单 确实 给 出 了 一 套 价值 体系 。 
— 那 套 价值 体系 才 该 是 目标 ， 也 是 本 书 的 主题 所 在 。 整 洁 代码 并 非 遵循 一 套 规 则 写 就 。 学 
习 一 系列 启发 并 不 足以 让 你 成 为 软件 匠人 。 专 业 性 和 技艺 来 自 于 驱动 规程 的 价值 观 。 
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附录 


并 发 编程 I 


Brett L.Schuchert 


本 附录 扩充 了 “并 发 编程 ”一 章 的 内 容 ， 由 一 组 相互 独立 的 主题 组 成 ， 你 可 以 按 随意 顺 
序 阅 读 。 为 了 实现 这 样 的 阅读 方式 ， 节 与 节 之 间 存 在 一 些 重复 内 容 。 


A.1 客户 端 /服务 器 的 例子 


想像 一 个 简单 的 客户 端 /服务 器 应 用 程序 。 服务器 在 一 个 套 接 字 上 等 待 接受 来 目 客户 端的 
连接 请 求 。 客 户 端 连 接 到 服务 器 并 发 送 请 求 。 


A.1.1 服务 器 


下 面 是 服务 器 应 用 程序 的 简化 版 本 代码 。 在 后 文 “客户 端 /服务 器 非 多 线程 版 本 ”一 节 中 
有 完整 的 代码 。 


ServerSocket serverSocket = new ServerSocket(8009); 


while (keepProcessing) { 
try { 
Socket socket = serverSocket.accept(); 
process (socket); 
} catch (Exception e) { 
handle (e); 
) 
) 
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这 个 简单 的 应 用 等 待 连接 请 求 ， 处 理 接收 到 的 新 消息 ， 再 等 待 下 一 个 客户 端 请 求 。 下 面 
是 连接 到 服务 器 的 客户 端 代码 ; 


private void connectSendReceive(int i) { 
try ( 
Socket socket = new Socket("localhost", PORT); 
MessageUtils.sendMessage (socket, Integer.toString(i)); 
MessageUtils.getMessage (socket); 
socket.close(); 
) catch (Exception e) { 
e.printStackTrace(); 
) 
) 


这 对 客户 端 /服务 器 程序 运行 得 如 何 呢 ? 怎样 才能 正式 地 描述 其 性 能 ? 下 面 是 断言 其 性 
能 “可 接受 ”的 测试 ， 


GTest (timeout = 10000) 

public void shouldRunInUnderl0Seconds() throws Exception { 
Thread[] threads = createThreads(); 
startAllThreadsw (threads); 
waitForAllThreadsToFinish (threads); 

) 


为 了 让 例子 够 简单 ， DEENS? ( 见 后 文 ClenfTextjave RAN). WAME 程序 应 
该 在 10000 毫秒 内 完成 。 

这 是 个 验证 系统 吞吐 量 的 典型 例子 。 系统 应 该 在 10 秒 钟 以 内 完成 一 组 客户 端 请 求 。 只 要 
服务 器 能 在 时 限 内 处 理 每 个 客户 端 请 求 ， 测 试 就 通过 了 。 

如 果 测 试 失 败 会 怎样 ? 缺少 了 某 些 事件 轮 询 机 制 ， 在 单个 线程 上 也 没什么 可 让 代码 更 快 
的 手段 。 使 用 多 线程 能 解决 问题 吗 ? 可 能 会 ， 我 们 先 得 了 解 什么 地 方 耗费 时 间 。 下 面 是 两 种 
可 能 : 

。 1/O 一 一 使 用 套 接 字 、 连 接 到 数据 库 、 等 待 虚拟 内 存 交 换 等 ， 

e 处理 器 一 一 数值 计算 、 正 则 表达 式 处 理 、 垃 圾 回收 等 。 

以 上 在 系统 中 都 会 部 分 存在 ， 但 对 于 特定 的 操作 ， 其 中 之 一 会 起 主导 作用 。 如 果 代 码 运 
行 速度 主要 与 处 理 器 有 关 ， 增 加 处 理 器 硬件 就 能 提升 吞吐 量 ， 从 而 通过 测试 。 但 CPU 运算 周 
期 是 有 上 限 的 ， 因 此 ， 只 是 增加 线程 的 话 并 不 会 提升 受 处 理 器 限制 的 代码 的 速度 。 

AFA, MRELBS WO 有 关 ， 则 并 发 编程 能 提升 运行 效率 。 当 系统 的 某 个 部 分 在 
等 待 JO， 另 一 部 分 就 可 以 利用 等 待 的 时 间 处 理 其 他 事务 ， 从 而 更 有 效 地 利用 了 CPU 能 力 。 


A.1 己 ”添加 线程 代码 


假定 性 能 测试 失败 了 。 如 何 才能 提高 吞吐 量 、 通 过 性 能 测试 呢 ? 如 果 服 务 器 的 process 
方法 与 IO 有 关 ， 就 有 个 办 法 让 服务 器 利用 线程 (只 需要 修改 processMessage?: 
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|. void prócess(final Socket socket) { 
if (socket == null) 
return; 


Runnable clientHandler = new Runnable() { 
public void run() { 


try { 
String message = MessageUtils.getMessage (socket); 
MessageUtils.sendMessage(socket, "Processed: " + message); 


closeIgnoringException (socket); 
) catch (Exception e) { 
e.printStackTrace(); 
) 
) 
NU 


Thread clientConnection = new Thread(clientHandler); 
clientConnection.start(); 


} 
假设 修改 后 测试 通过 了  。 代 码 是 否 完整 、 正 确 了 呢 ? 


A.1.3 MARIRE SÜN 


修改 了 的 服务 器 成 功 通过 测试 ， 只 花费 了 一 秒 多 钟 时 间 。 不 往 的 是 ， 这 种 解决 手段 有 所 
一 厢 情 愿 ， 而 且 导 致 了 新 问题 产生 。 

服务 器 应 该 创建 多 少 个 线程 ? 代码 没有 设置 上 限 ， 所 以 我 们 很 有 可 能 达到 Java 虚拟 机 
(JVM) 的 限制 。 对 于 许多 简单 系统 来 说 这 无 所 谓 。 但 如 果 系统 要 支持 公众 网 络 上 的 众多 用 户 
Me? 如 果 有 太 多 用 户 同时 连接 ， 系 统 就 有 可 能 挂 掉 。 

不 过 先 把 性 能 问题 放 到 一 边 吧 。 这 种 手段 还 有 整洁 性 和 结构 上 的 问题 。 服 务 器 代码 有 多 
少 种 权 责 呢 ? | 

e 套 接 字 连 接管 理 ， 

。 客户 端 处 理 ; 

。 ”线程 策略 、 | 

e 服务 器 关闭 策略 。 

这 些 权 责 不 幸 全 在 process 函数 中 。 而 且 ， 代码 跨越 多 个 抽象 层级 。 所 以 ， 即 便 process 
函数 这 么 短小 ， 还 是 需要 再 加 以 切 分 。 

服务 器 有 几 个 修改 的 原因 ， 所 以 它 违反 了 单一 权 责 原则 。 要 保持 并 发 系统 整洁 ， 应 该 
将 线程 管理 代码 约束 于 少数 几 处 控制 良好 的 地 方 。 而且, 管理 线程 的 代码 只 应 该 做 管理 线 
程 的 事 。 为 什么 ? 即便 无 需 同时 考虑 其 他 非 多 线程 代码 , 跟踪 并 发 问题 都 已 经 足够 困难 了 。 


" 原 注 : 你 可 以 自行 验证 修改 之 前 和 之 后 的 代码 。 复 查 前 文 的 非 多 线程 代码 。 复 查 之 后 的 多 线程 代码 。 
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如 果 为 上 述 每 个 权 责 〈 包 括 线 程 管理 权 责 在 内 ) 创建 单独 的 类 ， 当 改动 线程 管理 策略 时 ， 
就 会 对 整个 代码 产生 较 小 影响 ， 不 至 于 污染 其 他 权 责 。 这 样 一 来， 也 能 在 不 担心 线程 并 的 
前 提 下 测试 所 有 其 他 权 责 。 下 面 是 修改 过 的 版 本 : 


public void run() { 
while (keepProcessing) { 
try { 
ClientConnection clientConnection = connectionManager.awaitClient (); 
ClientRequestProcessor requestProcessor 
= new ClientRequestProcessor (clientConnection); 
 clientScheduler.schedule (requestProcessor); 
) catch (Exception e) { 
e.printStackTrace(); 
us 
) 





connectionManager.shutdown(); 


) 


所 有 与 线程 相关 的 东西 都 放 到 了 clientScheduler 里 面 。 MR HL Se 只 要 看 这 个 
地 方 就 好 了 : 


public interface ClientScheduler { 
void schedule(ClientRequestProcessor requestProcessor); 
) 


并 发 策略 易于 实现 : 


public class ThreadPerRequestScheduler implements ClientScheduler { 
public void schedule(final ClientRequestProcessor requestProcessor) ( 
Runnable runnable = new Runnable() { 
public void run() ( 
requestProcessor.process(); 
) 
}; 


Thread thread = new Thread(runnable); 
thread.start(); 
) 
) 


把 所 有 线程 管理 隔离 到 一 个 位 置 ， 修 改 控制 线程 的 方式 就 容易 多 了 。 例 如 ， 移 植 到 Java 
5 Executor 框架 就 只 需要 编写 一 个 新 类 并 插 进 来 即 可 《如 代码 清单 A-1 所 示 )。 


代码 清单 A-1 ExecutorClientScheduler.java 


import java.util.concurrent.Executor; 
import java.util.concurrent.Executors; 


public class ExecutorClientScheduler implements ClientScheduler { 
Executor executor; 


public ExecutorClientScheduler(int availableThreads) ( 


A.2 执行 的 可 能 路 径 301 
executor = Executors.newFixedThreadPool (availableThreads); 


) 


public void schedule(final ClientRequestProcessor requestProcessor) { 
Runnable runnable = new Runnable() { 
public void run() { 
requestProcessor.process(); 


); 
executor.execute(runnable); 
} : 

) 


A.14 小结 


本 例 介 绍 的 并 发 编程 ， 演 示 了 一 种 提高 系统 吞吐 量 的 方法 ， 以 及 一 种 通过 测试 框架 验证 
吞吐 量 的 方法 。 将 全 部 并 发 代码 放 到 少数 类 中 ， 是 应 用 单一 权 责 原则 的 范例 。 对 于 并 发 编程 ， 
因 其 复杂 性 ， 这 一 氮 尤其 重要 。 | 


A.2 执行 的 可 能 路 径 


复查 没有 循环 或 条 件 分 支 的 单行 Java 方法 incrementValue: 


public class IdGenerator { 
int lastIdUsed; 


public int incrementValue() { 
return t*lastIdUsed; 
) | | 
忽略 整数 溢出 的 情形 ， 假 定 只 有 单个 线程 能 访问 IdGenerator 的 单个 实体 。 这 种 情况 下 ， 
只 有 一 种 执行 路 径 和 一 个 确定 的 结果 : 
e ”返回 值 等 于 lastIdUsed 的 值 ， 两 者 都 比 调用 方法 前 大 1。 

如 果 使 用 两 个 线程 、 不 修改 方法 的 话 会 发 生 什 么 ? 如果 每 个 线程 都 调用 一 次 
incrementValue， 可 能 得 到 什么 结果 呢 ? 有 多 少 种 可 能 执行 路 径 ? 首先 来 看 结果 (假定 
lastIdUsed 初始 值 为 93): 

e ”线程 1 得 到 94， 线 程 2 得 到 95，lastIdUsed 为 95; 

e 线程 1 得 到 95， 线 程 2 得 到 94，lastIdUsed 为 95; 

e 线程 1 得 到 94， 线 程 2 得 到 94，lastIdUsed 为 94. 

最 后 一 个 结果 尽管 令 人 吃惊 ， 也 是 有 可 能 出 现 的 。 要 想 明 白 为 何 可 和 和 EE 出 现 这 些 结果 ， 就 
需要 理解 可 能 执行 路 径 的 数量 以 及 Java 虚拟 机 是 如 何 执 行 这 些 路 径 的 。 | 
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2.1 BRE 


HastldUsed;) 变 成 了 8 个 字 节 码 指令 。 两 个 线程 有 可 能 交错 执行 这 8 个 指令 ， 就 1 
洗 牌 时 交错 牌 张 一 样 1。 即 便 每 只 手 上 只 有 8 张 牌 ， 洗 牌 得 到 的 结果 数量 也 很 可 观 。 


对 于 指令 系列 中 有 NN 个 指令 和 了 个 线程 、 没 有 循环 或 条 件 分 支 的 简单 情况 ， 总 
行路 径 数 量 等 于 









对 于 一 行 Java 代码 (等 同 于 8 行 字 节 码 ) 和 两 个 线程 的 简单 情况 ， 可 能 执行 路 径 的 总 
量 就 是 12870。 如 果 lastIdUsed 的 类 型 为 l ong， 每 次 读 / 写 操作 都 变 成 了 两 次 操作 ， 而 可 能 也 


cr YE 





' 原 注 : 这 说 得 有 点 简单 了 。 鉴 于 讨论 的 目的 ， 我 们 就 用 这 个 简化 模型 好 了 。 
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次 序 高 达 2704156 种 。 
如 果 改 动 一 下 该 方法 会 怎样 ? 


public synchronized void incrementValue() | 
++lastIdUsed; 
} 


这 样 一 来 ， 对 于 两 个 线程 的 情况 ， 可 能 执行 路 径 的 数量 就 是 2， 即 N!。 
Ace RAISI 


两 个 线程 都 调用 方法 一 次 《在 添加 synchronize 之 前 )、 得 到 同一 结果 数字 的 惊异 结果 又 
怎样 呢 ? 怎么 可 能 出 现 这 种 情况 ?一样 一 样 来 。 

什么 是 原子 操作 ? 可 以 把 原子 操作 定义 为 不 可 中 断 的 操作 。 例如 , 在 下 列 代码 的 第 5 行 ， 
0 被 赋值 给 lastid， 就 是 一 个 原子 操作 。 因 为 依据 Java 内 存 模型 ，32 位 值 的 赋值 操作 是 不 可 
"PISTE. | 


01: public class Example { 
02: int lastId; 


04: public void resetId() { 


05: value = 0; 

06: ) 

07: 

08: public int gecesi”) { 
09; ++value; 

10: } 

11: } 


如 果 把 lastId 的 类 型 从 int 改 为 long 会 怎样 ? 第 5 行 还 是 原子 操作 吗 ? 如 果 不 考 虑 JVM 
规约 ， 则 有 可 能 根据 处 理 器 不 同 而 不 同 。 不 过 ， 根 据 JVM 规约 ，64 位 值 的 赋值 需要 两 次 
”32 位 赋值 。 这 意 味 着 在 第 一 次 和 第 二 次 32 位 赋值 之 间 ， 其 他 线程 可 能 插 进 来 ， 修 改 其 中 
2 Ee 
| 第 9 行 的 前 递增 操作 符 ++ 又 怎样 呢 ? 前 递增 操作 符 可 以 被 中 断 ， 所 以 它 不 是 原子 的 。 为 
了 理解 这 点 ， 仔 细 复 查 一 下 这 些 方法 的 字 节 码 吧 。 

e JEX 
SLR RH Lease. 这 是 定义 “个 调用 堆栈 的 标准 技术 ， 现代 编程 语言 
来 实现 基本 函数 /方法 调用 和 递归 调用 ; | 

e ”本 地 变量 一 一 方法 作用 范围 内 定义 的 每 个 变量 。 所 有 非 静态 方法 至 少 有 一 个 变量 
this, 代表 当前 对 象 , 即 接收 导致 方法 调用 的 (当前 线程 内 ) 大 多 数 最 新 消息 的 对 象 ; 

e ”运算 对 象 栈 一 一 Java 虚拟 机 中 的 许多 指令 都 有 参数 .运算 对 象 栈 是 放置 参数 的 地 方 。 
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堆栈 是 个 标准 的 后 入 先 出 〈LIFO) 数据 结构 。 
下 面 是 restId( ) 的 字 节 码 ， 如 表 A-1 所 示 。 


AA restid( ) 的 字 节 码 | 
指令 | 描述 | 操作 对 象 栈 
ALOAD 0 将 第 0 个 变量 放 到 操作 对 象 栈 中 。 什 么 是 第 0 138 | this 

量 ? 就 是 this， 当 前 对 象 。 当 方法 被 调用 ， 消 息 接 
收 者 ，Example 的 一 个 实体 ， 被 推 到 为 方法 调用 创 
建 的 框架 的 本 地 变量 数组 中 。 这 总 是 放 进 每 个 实体 





方法 的 第 一 个 变量 


ICONST 0 将 常量 值 0 放 到 操作 对 象 栈 中 . jiis, 0 


PUTFIELD lastld | 将 堆栈 中 的 第 一 个 值 ( 即 00 存储 到 引用 对 象 的 字 | «empty? 
段 值 ,: 距 堆栈 顶部 this 一 个 对 象 引 用 的 距离 


这 三 个 指令 确保 是 原子 的 , 因为 尽管 执行 它们 的 线程 可 能 在 其 中 任何 一 个 指令 后 被 打 断 ， 
但 PUTFIELD 指令 (堆栈 顶部 的 常量 值 0 和 顶端 之 下 的 this 引用 及 其 字段 值 ) 的 信息 并 不 能 
为 其 他 线程 所 触及 。 所 以 ， 当 赋值 操作 发 生 时 ， 值 0 一 定 将 存储 到 字段 值 中 。 该 操作 是 原子 
的 。 操 作对 象 都 处 理 对 于 方法 而 言 是 本 地 的 信息 ， 故 在 多 个 线程 之 间 并 无 冲突 。 

所 以 , 如 果 这 三 个 指令 由 10 个 线程 执行 , 就 会 有 4.38679733629e+24 种 可 能 的 执行 次 序 。 
不 过 ， 只 会 有 一 种 可 能 的 结果 ， 所 以 执行 次 序 不 同 无 关 紧 要 。 对 于 本 例 中 的 long 常量 ， 总 是 
有 同一 种 运算 结果 。 为 什么 ?因为 10 个 线程 的 赋值 操作 都 是 针对 一 个 常量 的 。 即便 它们 互相 
干涉 ， 结 果 也 是 一 样 。 

方法 getNextId 中 的 ++ 操 作 就 会 有 问题 了 。 假 定 lastId 在 方法 开始 时 的 值 为 42. 下 面 是 新 
方法 的 字 节 码 ， 如 表 A-2 Pra. | | 


SS A-2 新 方法 的 字 节 码 
CE San 
DUP 


复制 堆栈 顶部 内 容 。 在 对 象 栈 中 有 两 个 this 的 复 本 ` this, this 
GETFIELD ”| 从 指向 堆栈 顶部 this) 的 对 象 中 取得 字段 lastId 的 值 ，| this, 42 
lastld 并 存储 回 堆栈 中 


IADD 对 堆栈 项 部 的 两 个 值 做 整数 加 操作 ， 将 结果 存储 回 堆栈 | this, 43 
value 对 象 栈 中 的 下 一 个 值 this | 
A 


IRETURN 返回 堆栈 顶部 (而 且 只 是 顶部 ) 的 值 <empty> 
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设想 第 一 个 线程 完成 了 前 三 个 操作 ， 直 到 执行 完 GETFIELD， 然 后 被 打 断 。 第 二 个 线程 
接手 并 完成 整个 方法 调用 ，lastId 的 值 递增 1; 得 到 的 值 为 43。 第 一 个 线程 再 从 中 断 处 继续 执 
行 ; 操作 对 象 栈 中 的 值 还 是 42, 因为 那 就 是 该 线程 执行 GETFIELD 时 的 lastId 值 , 线 程 给 lastId 
加 1， 得 到 43， 存 储 这 个 结果 。 第 一 个 线程 也 得 到 了 值 43。 结 果 就 是 其 中 一 个 递增 操作 丢失 
了 ， 因 为 第 一 个 线程 在 被 第 二 个 线程 打 断 后 又 踏 入 了 第 二 个 线程 中 。 

将 getNextId( ) 方 法 修改 为 同步 方法 就 能 修正 这 个 问题 。 
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“理解 线程 之 间 如 何 互 相干 涉 ， 并 不 一 定 要 精通 字 节 码 。 如 果 你 能 看 明白 这 个 例子 ， 它 应 
该 已 经 展示 了 多 个 线程 之 间 互 相干 涉 的 可 能 性 ， 这 已 经 足够 了 。 

这 个 小 例子 说 明 ， 有 必要 尽量 理解 内 存 模型 ， 明 日 什么 是 安全 的 ， 什 么 是 不 安全 的 。 
有 一 种 普遍 的 误解 ， 认 为 ++ (前 递增 或 后 递增 ) 操作 符 是 原子 的 ， 其 实 并 非 如 此 。 你 必 
须知 道 ; 

° 什么 地 方 有 共享 对 象 / 信 ; 

e 哪些 代码 会 导致 并 发 读 / 写 问题 ; 

e 如何 防止 这 种 并 发 问题 发 生 。 


A.3 THRE 


A.3.1 Executor 框架 


如 前 文 ExecutorClientScheduler.java 所 演示 的 那样 , Java 5 中 引入 的 Executor 框架 支持 利 
用 线程 池 进 行 复 杂 的 执行 。 那 就 是 java.util.concurrent 包 中 的 一 个 类 。 

如 果 在 创建 线程 时 没有 使 用 线程 池 或 自行 编写 线程 池 ， 可 以 考虑 使 用 Executor。 它 能 让 
代码 更 整洁 ， 易 于 理解 ， 且 更 加 短小 。 

Executor 框架 将 把 线程 放 到 池 中 ， 自 动 调整 其 大 小 ， 并 在 必要 时 重建 线程 。 它 还 支持 
future， 一 种 通用 的 并 发 编程 构造 。Executor 能 与 实现 了 Runnable 的 类 协同 工作 ， 也 能 与 实 
现 了 Callable 接口 的 类 协同 工作 。Callback 看 来 就 像 是 Runnable， 但 它 能 返回 一 个 结果 ， a 
在 多 线程 解决 方案 中 是 普遍 的 需求 。 

当代 码 需 要 执行 多 个 相互 独立 的 操作 并 等 待 这 些 操 作 结 束 时 ，future 刚好 就 手 : 


public String processRequest (String message) throws Exception { 
Callable<String> makeExternalCall = new Callable<String>() { 
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public String call() throws Exception { 
String result - ""; 
// make external request 
return result; 
) 
}; 


Future<String> result = executorService.submit (makeExternalCall); 
String partialResult = doSomeLocalProcessing(); 
return result.get() + partialResult; 


. 
在 本 例 中 ， 方 法 开始 执行 makeExternalCall 对 象 。 然 后 该 方法 继续 其 他 操作 。 最 后 一 行 
代码 调用 result ge )， 在 future 代码 执行 完成 前 ， 这 个 操作 是 锁定 的 。 


A32 非 锁定 的 解决 万 潜 


Java5 虚拟 机 利用 了 现代 处 理 器 支持 可 靠 、 非 锁定 更 新 的 设计 优点 。 例 如 ， 考 虑 某 个 使 
用 同步 〈 从 而 也 是 锁定 的 ) 来 提供 线程 安全 地 更 新 一 个 值 的 类 : 
public class ObjectWithValue { 
private int value; 
public void synchronized incrementValue() ( ++value; } 
public int getValue() { return value; } | 


) 
Javas 有 一 系列 用 于 此 类 情况 的 新 类 , 例如 AtomicBoolean. AtomicInteger 和 AtomicReference 
等 ， 还 有 另外 一 些 。 我 们 可 以 重 写 上 面 的 代码 ， 使 用 非 锁定 的 手段 ， 如 下 所 示 : 


public class ObjectWithValue { 
private AtomicInteger value = new AtomicInteger(0); 


public void incrementValue() { 
value.incrementAndGet (); 


) 


public int getValue() { 
return value.get(); 
) 
) 


即便 使 用 了 对 象 而 非 直 接 操作 ， | 使 用 了 incrementAndGet( ) 这 样 的 信息 发 送 方式 而 非 ++ 
操作 ， 这 个 类 的 性 能 还 是 几乎 总 能 胜 过 上 一 版 本 。 在 某 些 情况 下 只 会 快 一 点 点 ， 但 较 慢 的 情 
形 却 几 乎 不 存在 。 | 


怎么 会 这 样 ? 现代 处 理 器 拥有 一 种 通常 称 为 比较 交换 (Compare and Swap, CAS) 的 操 


作 。 这 种 操作 类 似 于 数据 库 中 的 乐观 锁定 ， 而 其 同步 版 本 则 类 似 于 保守 锁定 。 
关键 字 synchronized 总 是 要 求 上 锁 ， 即 便 第 二 个 线程 并 不 更 新 同一 值 时 也 如 此 。 尽 管 这 
种 固有 锁 的 性 能 一 直 在 提升 ， 但 仍然 代价 昂贵 。 


Mat. 
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非 上 锁 的 版 本 假定 多 个 线程 通常 并 不 频繁 修改 同一 个 值 ， 导 致 问题 产生 。 它 高 效 地 侦 测 
这 种 情形 是 否 发 生 ， 并 不 断 尝试 ， 直 至 更 新 成 功 。 这 种 侦 测 行为 几乎 总 是 比 上 锁 来 得 划算 ， 
在 争 用 激烈 的 情况 下 也 是 如 此 ，。 | 

虚拟 机 如 何 实现 这 种 机 制 ? CAS 的 操作 是 原子 的 。 逻 辑 上 ，CAS 操作 看 起 来 像 这 样 ， 


int variableBeingSet; 


void simulateNonBlockingSet (int newValue) i 
int currentValue; 


do { 
currentValue = variableBeingSet | 
} while(currentValue != compareAndSwap (currentValue, newValue)); 


d 


int synchronized compareAndSwap(int currentValue, int newValue) { 
if(variableBeingSet == currentValue) { 
variableBeingSet = newValue; 
return currentValue; 
) 
return variableBeingSet; 


} 

当 某 个 方法 试图 更 新 一 个 共享 变量 ，CAS 操作 就 会 验证 要 赋值 的 变量 是 否 保有 上 一 次 的 
已 知 值 。 如 果 是 ， 就 修改 变量 值 。 如 果 不 是 ， 则 不 会 碰 变 量 ， 因 为 为 一 个 线程 正在 试图 更 新 
变量 值 。 要 更 新 数据 的 方法 (通过 CAS 操作 ) 查看 是 否 修 改 并 持续 尝试 。 


A.3.3” 非 线程 安全 类 


有 些 类 天 生 不 是 线程 安全 的 。 下 面 是 几 个 例子 : 


ge 数据 库 连 接 
e java.util 中 的 容器 
e Servlet 


”注意 ， 有 些 群集 类 拥有 一 些 线程 安全 的 方法 。 不 过 , 涉及 调用 多 个 方法 的 操作 都 不 是 
线程 安全 的 。 例 如 ， 如 果 因 为 HashTable 中 已 经 有 某 物 而 不 打算 替换 它 ， 可 能 会 写 出 以 下 
代码 : | | 


if (!hashTable.containsKey(someKey)) { 
hashTable.put(someKey, new SomeValue()); 
) 


单个 方法 是 线程 安全 的 。 不 过 ， 另 一 个 线程 却 可 能 在 containsKey 和 put 调用 之 间 塞 进 一 
个 值 。 有 几 种 修正 这 个 问题 的 手段 。 
© ” 先 锁定 HashTable， 确 定 其 他 使 用 者 都 做 了 基于 客户 端的 锁定 : 
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synchronized(map) { 
if (!map.conainsKey (key) ) 
map .put (key, value); 


} | 
。 ”用 其 对 象 包装 HashTable, 并 使 用 不 同 的 APL 利用 ADAPTER 模式 做 基于 服务 端 
的 锁定 : 


public class WrappedHashtable«K, V» { 
private Map«K, V» map = new Hashtable«K, V>(); 


public synchronized void putIfAbsent (K key, V value) { 
if (map.containsKey (key)) 
map.put(key, value); 
) 
) 


。 采用 线程 安全 的 群集 : 


ConcurrentHashMap<Integer, String> map = new ConcurrentHashMap<Integer, String>(); 
map.putIfAbsent (key, value); ) ) 


在 java.util.concurrent 中 的 群集 都 有 putIfAbsent( ) 之 类 提供 这 种 操作 的 方法 。 


A.4 方法 之 间 的 依赖 可 能 破坏 并 发 代码 


以 下 是 一 个 有 关 在 方法 间 引 入 依赖 的 小 例子 : 


public class IntegerIterator implements Iterator<Integer> 
private Integer nextValue = 0; 


public synchronized boolean hasNext() { 
return nextValue < 100000; 
) 


public synchronized Integer next() ( 
if (nextValue == 100000) 
throw new IteratorPastEndException(); 
return nextValuet*; 


) 


public synchronized Integer getNextValue() { 
return nextValue; 
) 
) 


下 面 是 使 用 Integeriterator 的 代码 ; 
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IntegerIterator iterator = new IntegerIterator(); 
while (iterator.hasNext()) { 

int nextValue = iterator.next(); 

// do something with nextValue 


) 


如 果 只 有 一 个 线程 执行 这 段 代 码 ， 不 会 有 什么 问题 。 但 如 果 有 两 个 线程 抱 着 每 个 线程 都 
处 理 它 获 得 的 值 、 但 列表 中 的 每 个 元 素 都 只 被 处 理 一 次 的 意图 ， 尝 试 共享 Integerlterator 的 单 
个 实体 ， 会 发 生 什么 事 ? 多 数 时 候 什 么 也 不 会 发 生 ， 线 程 开 心地 共享 着 列表 ， 处 理 从 和 迭代 器 
获取 的 元 素 ， 在 迭代 器 完成 执行 时 停 下 。 然 而 ， 在 迭代 的 末尾 ， 两 个 线程 也 有 少量 可 能 互相 
干涉 ， 导 致 其 中 一 个 超出 迭代 器 末尾 ， 抛 出 异常 。 

问题 在 这 里 。 线 程 1 调用 hasNext( ) 方 法 ， 该 方法 返回 true。 线 程 1 占 先 ， 然 后 线程 2 也 
调用 这 个 方法 ， 同 样 返回 tue。 线 程 2 接着 调用 next( )， 该 方法 如 期 返回 一 个 值 ， 但 副作用 
是 之 后 再 调用 hasNext( ) 就 会 返回 false。 线 程 1 继续 执行 ， 以 为 hasNext( je true， 然 后 调 
用 next( )。 即 便 单 个 方法 是 同步 的 ， 客 户 端 还 是 使 用 了 两 个 方法 。 

这 的 确 是 个 问题 ， 也 是 并 发 代码 中 此 类 问题 的 典型 例子 。 在 这 个 特殊 例子 中 ， 问题 
尤其 隐蔽 ， 因 为 只 有 在 迭代 器 最 后 一 次 迭代 时 发 生 才 会 导致 错误 。 如 果 线 程 刚好 在 那个 
点 中 断 ， 其 中 一 个 线程 就 可 能 超出 迭代 器 末尾 。 这 类 错误 往往 在 系统 部 署 之 后 很 久 才 发 
生 ， 而 且 很 难 追 踪 。 

出 现 错误 时 ， 你 有 3 种 做 法 。 

e 容忍 错误 ; 

。 ”修改 客户 代码 解决 问题 : 基于 客户 代码 的 锁定 ; 

© 修改 服务 端 代码 解决 问题 ， 同 时 也 修改 了 客户 代码 : 基于 服务 端的 锁定 。 
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有 时 ， 可 以 通过 一 些 设置 让 错误 不 会 导致 损害 。 例 如 ， 上 述 客户 代码 可 以 捕捉 并 清理 异 
常 。 坦 白地 说 ， 这 有 点 草草 从 事 ， 就 像 是 半夜 重启 解决 内 存 泄露 问题 一 样 。 


Ad2 ”基于 客户 代码 的 锁定 


要 让 Integerlterator 在 多 线程 情况 下 正确 运行 ， 对 客户 代码 做 如 下 修改 : 
IntegerIterator iterator = new IntegerIterator(); 


while (true) { 
int nextValue; 
synchronized (iterator) { 
if (literator.hasNext()) 


(310 HRA FRARI 


break; 
nextValue = iterator.next(); 


) 
doSometingWith (nextValue); 


每 个 客户 端 都 通过 synchronized 关键 字 引 入 一 个 锁 。 这 种 重复 违反 了 DRY 原则 , 但 如 果 
代码 使 用 非 线 程 安全 的 第 三 方 工具 ， 可 能 必须 这 样 做 。 

这 种 策略 有 风险 ， 因 为 使 用 服务 端的 程序 员 都 得 记 住 在 使 用 前 上 锁 、 用 过 后 解锁 。 许 多 
(许多 !) 年 前 ， 我 遇 到 过 一 个 在 共享 资源 上 应 用 基于 客户 代码 锁定 的 系统 。 代 码 中 有 几 百 处 
用 到 这 个 资源 的 地 方 。 有 位 可 怜 的 程序 员 坊 记 在 其 中 一 处 做 资源 锁定 。 

该 系统 是 个 多 终端 分 时 系统 ， 为 Local 705 卡车 司机 联盟 运行 会 计 软 件 。 计 算 机 放 在 距 
Local 705 总 部 50 英里 〈 约 84.65km) 以 北 的 一 间 镶 有 高 于 地 面 的 地 板 、 环 境 可 控 的 机 房 中 。 
总 部 有 几 十 位 数据 录入 员 ， 往 终端 输入 记录 。 终 端 使 用 电话 专线 和 600bit/s 的 半 双 工 调 制 解 
调 器 连接 到 计算 机 。( 这 可 是 很 久 很 久 以 前 的 事 了 。) 

每 天 大 概 都 会 有 一 台 终 端 毫 无 理由 地 “ 死 锁 ”。 死 锁 也 不 限定 在 某 些 终端 或 特定 时 间 。 就 
像 是 有 人 掷 山 子 选择 死 锁 的 时 机 和 终端 一 般 。 有 时 ， 会 有 几 台 终端 死 锁 。 有 了 时， 好几 天 都 不 
出 现 死 锁 情况 | 

刚 开 始 ， 唯 一 的 解决 手段 就 是 重启 。 但 协同 起 来 很 不 便 。 我 们 得 打 电 话 给 总 部 ， 让 大 家 
都 完成 在 终端 上 的 工作 。 然 后 我 们 才能 关机 、 重 启 。 如 果 有 人 在 做 要 花 上 一 两 个 小 时 才能 做 
完 的 事 ， 被 锁定 的 终端 就 只 能 一 直 等 着 。 

经 过 几 个 星期 的 调试 ， 我 们 发 现 ， 原 因 在 于 一 个 指针 不 同步 的 环形 缓冲 区 计数 器 。 该 组 
冲 区 控制 向 终端 的 输出 。 指 针 值 说 明 缓 冲 区 是 空 的 ， 但 计数 器 却 指 出 缓冲 区 是 满 的 。 因 为 组 
冲 区 是 空 的 ， 就 没什么 可 显示 ; 但 因为 缓冲 区 也 是 满 的 ， 也 就 无 法 向 其 中 加 入 可 在 屏幕 上 显 
示 的 内 容 。 

我 们 知道 了 终端 为 何 会 死 锁 ， 但 却 不 知道 为 什么 环形 缓冲 区 会 不 同步 。 我 们 用 了 点 手段 
发 现 问题 所 在 。 当 时 程序 能 够 读 取 计 算 机 的 前 面板 开关 状态 〈 这 可 是 很 久 很 久 以 前 的 事 了 )。 
我 们 写 了 个 陷阱 程序 ， 侦 测 这 些 开 关 何 时 被 拨 动 ， 然 后 查找 既 空 又 满 的 环形 缓冲 区 。 如 果 找 
到 ， 就 重 置 该 缓冲 区 为 空 。 乌 拉 ! 锁定 的 终端 又 重新 开始 显示 了 。 

这 样 ， 在 终端 锁定 时 就 不 必 重 启 系统 了 。 客 户 只 需要 打 电 话 告诉 我 们 出 现 死 锁 ， 我 们 就 
径直 走 到 机 房 ， 拨 动 一 下 开关 即 可 。 

当然 ， 有 时 他 们 会 在 周末 加 班 ， 但 是 我 们 可 不 加 班 。 所 以 我 们 又 在 计划 列表 中 添加 了 一 
个 函数 ， 每 分 钟 检查 一 次 全 部 环形 缓冲 区 ， 重 置 既 空 又 满 的 缓冲 区 。 在 客户 打 电 话 之 前 ， 显 
示 吏 已 经 恢复 正常 了 。 

在 发 现 问题 原因 之 前 ， 我 们 花 了 好 几 个 星期 查看 一 页 叉 一 页 的 单片机 汇编 语言 代码 。 我 
们 已 经 完成 计算 , 算出 死 锁 的 频率 是 周期 性 的 , 而 且 其 中 有 一 处 未 受 保护 的 环形 缓冲 区 使 用 。 
所 以 , 剩 下 的 任务 就 是 找 出 那个 错误 的 用 法 。 不 位 这 是 多 年 以 前 的 事 ， 那 时 既 没 有 搜索 工具 ， 
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也 没有 交 又 引用 或 任何 其 他 自动 化 帮助 手段 。 我 们 只 能 细 查 代码 清单 。 
在 芝加哥 1971 年 的 寒冬 ， 我 学 到 了 重要 的 一 课 。 基 于 客户 代码 的 锁定 实在 不 可 靠 。 


A.4.3 基于 服务 端的 锁定 


按照 以 下 方式 修改 IntegerIterator 也 能 消除 重复 : 


public class IntegerIteratorServerLocked { 
private Integer nextValue - 0; | 
public synchronized Integer getNextOrNull() { 
if (nextValue « 100000) 
return nextValuett; 
else 
return null; 
) 
) 


客户 代码 也 要 修改 : 


while (true) { 
Integer nextValue = iterator.getNextOrNull(); 
if (next == null) 
break; 
// do something with nextValue 


) 


在 这 种 情形 下 ， 我 们 实际 上 是 修改 了 类 的 API， 使 其 能 适应 多 线程 。 客 户 端 需要 做 null 
检查 ， 而 不 是 检查 hasNext( )。 

通 名 你 应 该 选用 基于 服务 闯 的 锁定 ， 因 为 : 

e ” 它 减 少 了 重复 代码 一 一 采用 基于 客户 代码 的 锁定 , 每 个 客户 端 都 要 正确 锁定 服务 
端 。 把 锁定 代码 放 到 服务 端 ， 客 户 端 就 能 自由 使 用 对 象 ， 不 必 费 心 编写 额外 的 锁 
定 代 码 ; | 

e _ 它 提升 了 性 能 一 一 在 单线 程 部 署 中 ， 可 以 用 非 多 线程 安全 服务 端 代码 替代 线程 安全 
客户 端 ， 从 而 省 去 花 销 ; 

© ERD T usua 

© "CTS RE 
个 客户 端 ) 实施 ; 

e 它 缩减 了 共享 变量 的 作用 范围 一 一 客户 端 不 必 关 心 它们 或 它们 是 如 何 锁定 的 。 一 切 
都 隐藏 在 服务 端 。 如 果 出 错 ， 要 侦 碍 的 范围 就 小 多 了 。 

如 果 你 无 法 修改 服务 端 代码 又 该 如 何 ? 








只 会 有 一 个 程序 员 忘记 上 锁 
该 策略 只 在 服务 端 这 一 处 地 方 实施 ， 而 不 是 在 许多 地 方 《 每 





| RÈ: KELE, Iterator 接口 天 生 不 是 线程 安全 的 。 它 并 不 为 多 线程 而 设计 ， 所 以 出 现 这 种 情况 也 不 奇怪 。 
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。 使 用 ADAPTER 模式 修改 API， 添 加 锁定 ; 


public class ThreadSafeIntegerIterator ( 
private IntegerIterator iterator - new IntegerIterator(); 


public synchronized Integer getNextOrNull() { 
if (iterator.hasNext()) 
return iterator.next(); 
return null; 
) 
} 


。 更 好 的 方法 是 使 用 线程 安全 的 群集 和 扩展 接口 。 


AS 提升 吞吐 量 


假设 我 们 打算 连接 上 网 ， 从 一 个 URL 列表 中 读 取 一 组 页 面 的 内 容 。 读 到 一 个 页 面 时 ， 解 
析 该 页 面 并 得 到 一 些 统计 结果 。 读 完 所 有 页 面 后 ， 打 印 出 一 份 提要 报表 。 
下 面 的 类 返回 给 定 URL 的 页 面 内容 ; 


public class PageReader { 
"PT 
public String getPageFor(String url) { 
HttpMethod method = new GetMethod (url); 


try { 
httpClient.executeMethod (method); 
String response - method.getResponseBodyAsString(); 
return response; 

) catch (Exception e) { 
handle(e); ` 

) finally ( 
method.releaseConnection(); 

) 

) 
) 


下 一 个 类 是 给 出 URL ETUR RET DUIS BUET SS, 


public class PageIterator { 
private PageReader reader; 
private URLIterator urls; 


public PageIterator(PageReader readér, URLIterator urls) { 
this.urls = urls; 


this.reader = reader; 


) 
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public synchronized String getNextPageOrNull() { 
if (urls.hasNext()) 

getPageFor (urls.next ()); 
else 

return null; 


) 


public String getPageFor(String url) ( 
return reader.getPageFor (url); 
) | 
} : 
Pagelterator 的 一 个 实体 可 为 多 个 不 同 线程 共享 , 每 个 线程 使 用 自己 的 PageReader 实体 读 
取 并 解析 从 友 代 器 中 得 到 的 页 面 。 

注意 , 我 们 把 synchronized 代码 块 的 数量 限制 在 小 范围 之 内 。 它 只 包括 深 处 于 Pagelterator 
内 部 的 临界 区 。 最 好 是 尽 可 能 少 地 使 用 同步 。 


AS.1 ”单线 程 条 件 下 的 吞吐 量 


来 做 个 简单 计算 。 鉴 于 讨论 的 目的 ， 假 定 : 

e 获取 一 个 页 面 的 IO 时 间 (平均 ) Æ ls; 

e 解析 一 个 页 面 的 处 理 时 间 (平均 ) 是 0.5s; 

© lO 操作 不 耗费 处 理 器 能 力 ， 而 解析 页 面 耗费 100% 处 理 器 能 力 。 

对 于 单个 线程 要 处 理 的 N 个 页 面 ， 总 的 执行 时 间 为 1.5s*N。 图 A-1 显示 了 13 个 页 面 或 
AE 19.5s 的 快照 。 


RAS 

wx, |] [E [L FLILIUILILILELIELEILEI 

获得 页 面 LLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLI 
图 A-1 单线 程 


AS 多 线程 条 件 下 的 吞吐 量 


如 果 能 够 以 任意 次 序 获得 页 面 并 独立 处 理 页 面 ， 就 有 可 能 利用 多 线程 提升 吞吐 量 。 如 果 
我 们 使 用 三 个 线程 会 如 何 ? 在 同一 时 间 内 能 获取 多 少 个 页 面 昵 ? 

如 你 在 图 A-2 中 所 见 ， 多 线程 方案 中 与 处 理 器 能 力 有 关 的 页 面 解析 操作 可 以 和 与 IO 有 
关 的 页 面 读 取 操 作 胎 加 进行 。 在 理想 状态 下 ， 这 意味 着 处 理 器 力 尽 其 用 。 每 个 耗 时 一 秒 钟 的 
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页 面 读 取 操 作 都 与 两 次 解析 操作 登 加 进行 。 这 样 ，. 我 们 就 能 在 每 秒 钟 内 处 理 两 个 页 面 ， 即 三 
倍 于 单线 程 方案 的 吞吐 量 。 


线程 1 


解析 页 面 [| II III [L TI III II III 


获得 页 面 LLILLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLL 


线程 2 


解析 页 面 nnnnnnnnnnnnn 


获得 页 面 A Od 


线程 3 


解析 页 面 [| [LÍ] [L [1 [| III III [| | | 


获得 页 面 LLLLELEEEEELEELELLEELLELFELLEFELLLLELLLLELA I 
图 A-2 ”三 个 并 发 线程 


A.6 SE 


想象 一 个 拥有 两 个 有 限 共享 资源 池 的 Web 应 用 程序 。 

。 一 个 用 于 本 地 临时 工作 存储 的 数据 库 连 接 池 ， 

e ”一 个 用 于 连接 到 主 存储 库 的 MQ ith. 

假定 该 应 用 中 有 两 个 操作 : 创建 和 更 新 。 

e 创建 一 一 获取 到 主 存 储 库 和 数据 库 的 连接 。 与 主 存储 库 协 调 ， 并 把 工作 保存 到 本 地 
临时 工作 数据 库 ; 

e 更 新 一 一 先 获取 到 数据 库 的 连接 ， 再 获取 到 主 存储 库 的 连接 。 从 临时 工作 数据 库 中 
读 取 数据 ， 再 发 送 给 主 存储 库 。 

如 果 用 户 数 量 多 于 池 的 大 小 会 怎样 ? 假设 每 个 池 中 能 容纳 10 个 资源 。 

e 有 10 个 用 户 尝试 创建 ， 获 取 了 10 个 数据 库 连接 ， 每 个 线程 在 获取 到 数据 库 连 接 之 
后 、 获 取 到 主 存储 库 连接 之 前 都 被 打 断 ; 

e 有 10 个 用 户 尝试 更 新 ， 获 取 了 10 个 主 存储 库 连 接 ， 每 个 线程 在 获取 到 主 存储 库 连 
接 之 后 、 获 取 到 数据 库 连 接 之 前 都 会 被 打 断 ; 

e 现在 那 10 个 “创建 ”线程 必须 等 待 获取 主 存 储 库 连 接 ， 但 那 10 个 “更 新 ”线程 必 
须 等 待 获 取 数 据 库 连 接 ; 
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e 死 锁 。 系 统 永远 无 法 恢复 。 
这 上 听 起 来 不 太 会 出 现 ， 但 谁 会 想 要 一 个 每 隔 一 周 观 僵 在 那里 不 动 的 系统 呢 ? 谁 想 要 
B d s re a 然后 得 花 上 好 几 个 星期 才能 
解决 。 

典型 的 “解决 方案 ”是 加 入 调试 语句 ， 发 现 问 题 。 当 然 ， 调 试 语句 对 代码 的 修改 足以 令 
死 锁 在 不 同情 况 下 发 生 ， 而 且 要 几 个 月 后 才 会 再 出 现 。 

要 真正 地 解决 死 锁 问题 ， 我 们 需要 理解 死 锁 的 原因 。 死 锁 的 发 生 需 要 4 个 条 件 : 

。 Dr 

。 上 锁 及 等 待 ; 

。 无 抢先 机 制 ; 

。 循环 等 待 。 ， 


A.6.1 Bf 


当 多 个 线程 需要 使 用 同一 资源 ， 且 这 些 资源 满足 下 列 条 件 时 ， 互 斥 就 会 发 生 。 

e ”无 法 在 同一 时 间 为 多 个 线程 所 用 ; 

e ”数量 上 有 限制 。 | 

这 种 资源 的 常见 例子 是 数据 库 连 接 、 打 开 后 用 于 写 入 的 文件 、 记 录 锁 或 是 信号 量 。 
Abe 上 锁 及 等 待 


当 某 个 线程 获取 一 个 资源 ， 在 获取 到 其 他 全 部 所 需 资源 并 完成 其 工作 之 前 ， 不 会 释放 这 
个 资源 。 


A63 无 抢先 机 制 


线程 无 法 从 其 他 线程 处 夺取 资源 。 一 个 线程 持 有 资源 时 ， 其 他 线程 获得 这 个 资源 的 唯一 
手段 就 是 等 竺 该 线程 释放 资源 。 


ABA MASTS 
这 也 被 称 为 “Fe tn 拥抱 ”。 想 象 两 个 线程 ，T1 和 T2， 还 有 两 个 资源 ，R1 gue T1 拥有 


' 原 注 ， 例如， 有 人 添加 了 一 些 调 试 输出 ， 问 题 “ 不 见 了 ”。 调 试 代码 “修正 ”了 问题 ， 其 实 问题 还 在 系统 中 存在 。 
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R1，T2 拥有 R2. TI 需要 R2，T2 需要 R1。 如 此 就 出 现 了 如 图 A-3 所 示 的 情形 。 
这 4 种 条 件 都 是 死 锁 所 必需 的 。 只 要 其 中 一 个 不 满足 ， 死 锁 就 不 会 发 生 。 


Ke 线程 ] | 
e ^ 
/ 
/ 


资源 2 资源 1 
f 
d 
E^ Aë 
线程 2 一 


图 A-3 ”循环 等 待 


ABS ABR 


避免 死 锁 的 一 种 策略 是 规避 互 斥 条 件 。 你 可 以 : 

。 ”使 用 允许 同时 使 用 的 资源 ， 如 AtomicInteger; 

e ”增加 资源 数量 ， 使 其 等 于 或 大 于 竞争 线程 的 数量 ， 

© 在 获取 资源 之 前 ， 检 查 是 否 可 用 。 

不 幸 的 是 ， 多 数 资源 都 有 上 限 ， 且 不 能 同时 使 用 。 而 且 第 二 个 资源 的 标识 也 常常 要 依据 
对 第 一 个 资源 的 操作 结果 来 判断 。 不 过 别 丧 气 ， 还 有 3 个 其 他 条 件 呢 。 


Abb Abr 


如 果 拒 绝 等 待 ， 就 能 消除 死 锁 。 在 获得 资源 之 前 检查 资源 ， 如 果 遇 到 某 个 繁忙 资源 ， 就 
释放 所 有 资源 ， 重 新 来 过 。 
这 种 手段 带 来 几 个 潜在 问题 : 
e 线程 饥饿 一 一 某 个 线程 一 直 无 法 获得 它 所 需 的 资源 〈 它 可 能 需要 某 种 很 少 能 同时 获 
得 的 资源 组 合 ); 
e ” 活 锁 一 一 几 个 线程 可 能 会 前 后 相连 地 要 求 获 得 某 个 资源 ， 然 后 再 释放 一 个 资源 ， 如 
此 循环 。 这 在 单纯 的 CPU 任务 排列 算法 中 尤其 有 可 能 出 现 〈 想 想 甬 入 式 设 备 或 单纯 
的 手写 线程 平衡 算法 )。 | | 
二 者 都 能 导致 较 差 的 吞吐 量 。 第 一 个 的 结果 是 CPU 利用 率 低 , 第 二 个 的 结果 是 较 高 但 无 
用 的 CPU 利用 率 。 
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尽管 这 种 策略 听 起 来 没 效 率 ， 但 也 好 过 没有 。 至 少 ， 如 果 其 他 方案 不 奏效 ， 这 种 手段 几 
乎 总 可 以 用 上 。 | 


AB.7 ”满足 抢先 机 制 


避免 死 锁 的 男 一 策略 是 允许 线程 从 其 他 线程 上 夺取 资源 。 这 通常 利用 一 种 简单 的 请 求 机 
制 来 实现 。 当 线程 发 现 资源 繁忙 ， 就 要 求 其 拥有 者 释放 之 。 如 果 拥 有 者 还 在 等 待 其 他 资源 ， 
就 释放 全 部 资源 并 重新 来 过 。 | | 

这 和 上 一 种 手段 相似 ， 但 好 处 是 允许 线程 等 待 资源 。 这 减少 了 线程 重新 月 动 的 次 数 。 不 
过 ， 管 理 所 有 请 求 可 要 人 花 点 心思 。 


ABB “不 做 循环 等 待 


这 是 避免 死 锁 的 最 常用 手段 。 对 于 多 数 系统 ， 它 只 要 求 一 个 为 各 方 认 同 的 约定 。 
在 上 面 的 例子 中 线程 1 同时 需要 资源 1 和 资源 2、 线程 2 同时 需要 资源 2 和 资源 1, 只 要 
强制 线程 1 和 线程 2 以 同样 次 序 分 配 资源 ， 循 环 等 待 就 不 会 发 生 。 
更 普 届 地 ， 如 果 所 有 线程 都 认同 一 种 资源 获取 次 序 ， 并 按照 这 种 次 序 获 取 资 源 ， 和 死 锁 聘 
不 会 发 生 。 就 像 其 他 策略 一 样 ， 这 也 会 有 问题 : 
。 获取 资源 的 次 序 可 能 与 使 用 资源 的 次 序 不 匹配 ， 一 开始 获取 的 资源 可 能 在 最 后 才 会 
用 到 。 这 可 能 导致 资源 不 必要 地 被 长 时 间 锁 定 ; 
。 ”有 时 无 法 强求 资源 获取 顺序 。 如 果 第 二 个 资源 的 ID 来 自 对 第 一 个 资源 操作 的 结果 ， 
获取 次 序 也 无 从 谈 起 。 
有 许多 避免 死 锁 的 方法 。 有 些 会 导致 饥饿 ， 另 外 一 些 会 导致 对 CPU 能 力 的 大 量 耗费 和 降 
低 响应 率 。TANSTAAFLI! — 
将 解决 方案 中 与 线程 相关 的 部 分 分 隔 出 来 ， 再 加 以 调整 和 试验 ， 是 获得 判断 最 佳 策略 所 
需 的 洞 见 的 正道 。 


AJ ”测试 多 线程 代码 


怎么 才能 编写 显示 以 下 代码 有 错 的 测试 呢 ? 


01: public class ClassWithThreadingProblem { 
02: int nextId; 
03: 


' 原 注 : 世上 没有 免费 的 午餐 (There ain't no such thing as a free lunch). 
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04: public int takeNextId() { 
05 : return nextId-**; 

06: } 

07: } 


下 面 是 对 能 证 明 上 列 代码 有 错 的 测试 的 描述 ; 

e iuf nextld 的 当前 值 ; 

e 创建 两 个 线程 ， 每 个 都 调用 takeNextId( ) 一 次 ; 

e 验证 nextId 比 开 始 时 大 2; | 
e 持续 运行 ， 直 至 发 现 nextId 只 比 开始 时 大 1 Wik. 
代码 清单 A-2 展示 了 这 样 一 个 测试 : | 


代码 清单 A-2 ClassWithThreadingProblemTest.java 


01: package example; 


02: 

03: import static org.junit.Assert.fail; 

04: 

05: import org.junit.Test; 

06: 

07: public class ClassWithThreadingProblemTest { 

08: Biest 

09: public void twoThreadsShouldFailEventually() throws Exception ( 

10: final ClassWithThreadingProblem classWithThreadingProblem 
= new ClassWithThreadingProblem(); 

11: 

12: Runnable runnable = new Runnable() { 

13: public void run() { 

14: classWithThreadingProblem.takeNextId(); 

152 } 

16: }; 

LL 

18: for (int i = 0; i < 50000; ++i) { 

19: int startingId = classWithThreadingProblem.lastId; 

20: int expectedResult = 2 + startingId; 

21: 

22: Thread tl = new Thread (runnable); 

23: Thread t2 = new Thread (runnable); 

24: tl.start(); 

25: t2.start(); 

26: tl.join(); 

Te t2.jcin(); 

28: 

29: int endingId = classWithThreadingProblem.lastId; 

205 

2315 if (endingId != expectedResult) 

32: return; 

33: 3} 

34: 

35: fail("Should have exposed a thréading issue but it did not."); 

56: ) 


37: } 
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X A-3 代码 清单 A-2 的 注解 

代码 行 描述 | | 

10 创建 ClassWithThreadingProblem 的 单个 实体 。 注意 ， 必 须 使 用 final 关键 字 ， 因 为 要 在 一 个 匿 
名 内 部 类 中 用 到 它 

12 一 16 创建 一 个 匿名 内 部 类 ， 该 类 用 到 ClassWithThreadingProblem 的 单个 实体 

18 运行 这 段 代 码 “足够 多 ”次 以 展示 代码 失败 ， 但 不 要 多 到 “ 花 太 长 时 间 ”。 这 是 种 平衡 行为 ; 
我 们 不 想 等 太 久 。 选 择 这 个 数字 有 扣 难 一 一 尽管 我 们 稍 后 会 看 到 能 够 极 大 地 降低 这 个 数字 

19 记 住 开始 时 的 值 。 这 个 测试 试图 证 明 ClassWithThreadingProblem 中 的 代码 有 错误 。 如 果 测 试 
| 通过 ， 它 就 证 明了 这 一 点 。 如 果 测 试 失 败 ， 它 就 没 能 证 明代 码 出 错 
20 我 们 期 望 最 终 值 比 当前 值 大 2 


22 一 23 创建 两 个 线程 ， 都 使 用 我 们 在 第 12-16 行 创建 的 对 象 。 这 样 两 个 线程 就 有 可 能 用 到 
ClassWithThreadingProblem 的 单个 实体 ， 互 相干 涉 | 


24~25 开始 运行 两 个 线程 
26~27 在 检查 结果 之 前 等 待 两 个 线程 结束 


29 记录 真实 的 最 终 值 m 
31—32 lendingld 是 否 与 期 待 值 不 一 样 ? 如 果 是 ， 测 试 结束 一 一 我 们 已 经 证 明了 代码 有 错误 。 如 果 不 
35 到 达 这 一 步 ， 测 试 无 法 证 明 产 品 代 码 在 “合理 范围 ”的 时 间 内 出 错 ; 测试 失败 了 。 要 么 是 代 


码 没 错 ， 要 么 是 没有 运行 足够 多 次 ， 错 误 条 件 还 没 满足 


这 个 测试 当然 设置 了 满足 并 发 更 新 问题 发 生 的 条 件 。 不 过 ， 问 题 发 生得 如 此 频繁 ， 测 试 
也 就 极 有 可 能 侦 测 不 到 。 | | 

实际 上 ， 要 真正 侦 测 到 问题 ， 需 要 将 循环 数量 设置 到 100 万 次 以 上 。 即 便 是 这 样 ， 在 10 
个 100 万 次 循环 的 执行 中 ， 错 误 也 只 发 生 了 一 次 。 这 意味 着 我 们 可 能 要 把 循环 次 数 设 置 为 超 
过 亿 次 才能 获得 可 靠 的 失败 证 明 。 要 等 多 久 呢 ? 

即便 我 们 调 优 测试 ， 在 单 台 机 器 上 得 到 可 靠 的 失败 证 明 ， 我 们 可 能 还 需要 用 不 同 的 值 来 
重新 设置 测试 ， 得 到 在 其 他 机 器 、 操 作 系统 或 不 同 版 本 的 JVM 上 的 失败 证 明 。 

而 且 这 只 是 个 简单 问题 。 如 果 连 这 个 简单 问题 都 无 法 轻易 获得 出 错 证 明 ， 我 们 怎么 能 真 
正 侦 测 复杂 问题 呢 ? 

我 们 能 用 什么 手段 来 证 明 这 个 简单 错误 呢 ? 而 且 ， 更 重要 的 是 ， 我 们 如 何 能 写 出 证 明 更 
复杂 代码 中 的 错误 的 测试 呢 ? 我 们 怎样 才能 在 不 知道 从 何 处 着 手 时 知道 代码 是 否 出 错 了 呢 ? 

下 面 是 一 些 想法 : | 

。 蒙特 卡 洛 测试 。 测 试 要 灵活 ， 便 于 调整 。 多 次 运行 测试 一 一 在 一 台 测 试 服 务 器 上 一 一 

随机 改变 调整 值 。 如 果 测 试 失 败 ， 代 码 就 有 错 。 确 保 及 早 编写 这 些 测试 ， 好 让 持续 集 
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成 服务 器 尽快 开始 运行 测试 。 另 外 ， 确 认 小 心 记录 了 在 何 种 条 件 下 测试 失败 。 
。 在 每 种 目标 部 署 平台 上 运行 测试 。 重 复 运行 。 持 续 运行 。 测 试 在 不 失败 的 前 提 下 运 

行 得 越久 ， 就 越 能 说 明 : | Hm 
- “生产 代码 正确 ; 





- ”测试 不 足以 暴露 问题 。 

。 ”在 另 一 台 有 不 同 负载 的 机 器 上 运行 测试 。 能 模拟 生产 环境 的 负载 ， 就 模拟 之 。 1 

。 ”即便 你 做 了 所 有 这 些 ， 还 是 不 见得 有 很 好 的 机 会 发 现代 码 中 的 线程 问题 。 最 阴险 的 3 
”问题 拥有 很 小 的 截面 , 在 十 亿 次 执行 中 只 会 发 生 一 次 。 这 类 错误 是 复杂 系统 的 疆 梦 。 | 


A.8 ”测试 线程 代码 的 工具 支持 


IBM 提供 了 一 个 名 为 ConTest 的 工具 。 它 能 对 类 进行 装置 , 令 非 线程 安全 代码 更 有 可 能 失败 。 

我 们 与 IBM 或 开发 ConTest 的 团队 没有 直接 关系 。 有 位 同事 发 现 了 这 个 工具 。 在 用 了 几 
分 钟 后 ， 我 们 发 现 自己 发 现 线程 问题 的 能 力 得 到 了 很 大 提升 。 

下 面 是 使 用 ConTest 的 简要 步骤 : 

。 编写 测试 和 生产 代码 , 确保 有 专门 模拟 多 用 户 在 多 种 负载 情况 下 操作 的 测试 , 如 上 文 所 述 ; 

° 用 ConTest 装置 测试 和 生产 代码 ;， 

。 运行 测试 。 

用 ConTest 装置 代码 后 , 原本 千 万 次 循环 才能 暴露 一 个 错误 的 比率 提升 到 30 次 循环 就 能 
找到 错误 。 以 下 是 装置 代码 后 的 几 次 测试 运行 结果 值 : 13、23、 0、54、16、14、6、69、107、 
49 和 2。 显 然 装 置 后 的 类 更 加 容易 和 可 靠 地 被 证 明 失 败 。 


A.9 小 结 


本 章 只 是 在 并 发 编程 广阔 而 可 怕 的 领地 上 的 短暂 去 留 轩 了。 我 们 只 触及 了 地 表 。 我 们 在 
这 里 强调 的 ， 只 是 保持 并 发 代码 整洁 的 一 些 规程 ,如 果 要 编写 并 发 系统 ， 还 有 许多 东西 要 学 。 
建议 从 Doug Lea 的 大 作 Concurrent Programming in Java: Design Principles and Patterns 开始 “。 | 

在 本 章 中 ， 我 们 谈 到 并 发 更 新 ， 还 有 清理 及 避免 同步 的 规程 。 我 们 谈 到 线程 如 何 提升 与 
VO 有 关 的 系统 的 吞吐 量 ， 展 示 了 获得 这 种 提升 的 整洁 技术 。 我 们 谈 到 死 锁 及 干净 地 避免 死 
锁 的 规程 。 最 后 ， 我 们 谈 到 通过 装置 代码 暴露 并 发 问题 的 策略 。 


' RË: http://www.haifa.ibm.com/projects/verification/contest/index.html . 
? 原 注 : 见 [Lea99]p.191。 
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A.10.1 SEI 25 es 3 Ex | UO 


代码 清单 A-3  Server.java 


package com.objectmentor.clientserver.nonthreaded; 


import java.io.IOException; 
import java.net.ServerSocket; 
import java.net.Socket; 

import java.net.SocketException; 


import common.MessageUtils; 


public class Server implements Runnable { 
ServerSocket serverSocket; 
volatile boolean keepProcessing = true; 


public Server(int port, int millisecondsTimeout) throws IOException { 
serverSocket = new ServerSocket (port); 
serverSocket.setSoTimeout (millisecondsTimeout); 


) 


public void run() { 
System.out.printf("Server Starting An"); 


while (keepProcessing) { 
try { 
een client\n") ; 
Socket socket = serverSocket.accept (); 
System.out.printf ("got client\n") ; 
process (socket) ; 
} catch (Exception e) { 
handle (e); 
) 
) 
) 


private void handle (Exception e) { 
if (!(e instanceof SocketException)) { 
e.printStackTrace(); 
} 
} 


public void stopProcessing() { 
keepProcessing = false; 
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closeIgnoringException (serverSocket); 


) 


void process(Socket socket) ( 
if (socket -- null) 
return; 


try { 
System.out.printf("Server: getting message\n") ; 
String message = MessageUtils.getMessage (socket) ; 
System.out.printf("Server: got message: %s\n", message); 
Thread.sleep (1000); 
System.out.printf("Server: sending reply: %s\n", message); 
MessageUtils.sendMessage (socket, "Processed: " + message); 
System.out.printf("Server: sent Wn"); 
closeIgnoringException (socket); j 
catch (Exception e) ( 
e.printStackTrace(); 

) 
) 


~~ 


private void closeIgnoringException (Socket socket) { 
if (socket != null) 
try { 
socket.close(); 
} catch (IOException ignore) { 
} 
} 


private void closeIgnoringException (ServerSocket serverSocket) { 
if (serverSocket != null) 
try { 
serverSocket.close(); 
} catch (IOException ignore) { 
) 





代码 清单 A-4  ClientTest.java 


package com.objectmentor.clientserver.nonthreaded; 


import java.io.IOException; 
import java.net.ServerSocket; 
import java.net.Socket; 

import java.net.SocketException; 


import common.MessageUtils; 


public class Server implements Runnable { 
ServerSocket serverSocket; 
volatile boolean keepProcessing = true; 
public Server(int port, int millisecondsTimeout) throws IOException { 
serverSocket = new ServerSocket (port) ; 
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serverSocket.setSoTimeout (millisecondsTimeout); 


) 


public void run() { 
System.out.printf("Server StartingWMn"); 


while (keepProcessing) { 
try { | 
System.out.printf("accepting client in"); 
Socket socket = serverSocket.accept(); 
System.out.printf("got client\n"); 
process (socket); 
) catch (Exception e) { 
handle (e); 
) 
) 
) 


private void handle(Exception e) { 
if (!(e instanceof SocketException)) { 
e.printStackTrace(); 
) 
) 


public void stopProcessing() { 
keepProcessing - false; 
closeIgnoringException (serverSocket); 


) 


void process(Socket socket) { 
if (socket == null) 
return; 


try { 
System.out.printf("Server: getting message\n"); 
String message - MessageUtils.getMessage (socket); 
System.out.printf("Server: got message: %s\n", message); 
Thread.sleep (1000); 
System.out.printf("Server: sending reply: $sMn", message); 
MessageUtils.sendMéssage(socket, "Processed: ”+ message); 
System.out.printf("Server: sent\n"); 
closeIgnoringException(socket); 
catch (Exception e) { 
e.printStackTrace(); 

) 
) 


— 


private void closeIgnoringException(Socket socket) { 
if (socket != null) 
try { 
socket.close(); 
} catch (IOException ignore) { 
} 
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private void closeIgnoringException(ServerSocket serverSocket) ( 
if (serverSocket != null) 
try { 
serverSocket.close(); 
) catch (IOException ignore) { 
} 


代码 清单 A-5  MessageUtils.java 


package common; 


import java.io.IOException; 

import java.io.InputStream; 

import java.io.ObjectInputStream; 
import java.io.ObjectOutputStream; 
import java.io.OutputStream; 
import java.net.Socket; 


public class MessageUtils ( 
public static void sendMessage(Socket socket, String message) 
throws IOException { 

OutputStream stream = socket.getOutputStream(); 
ObjectOutputStream oos = new ObjectOutputStream(stream) ; 
oos.writeUTF (message); 
oos.flush(); 

} 


public static String getMessage(Socket socket) throws IOException { 
InputStream stream = socket.getInputStream(); 
ObjectInputStream ois = new ObjectInputStream(stream) ; 
return ois.readUTF(); 
) 
) 


A102 fOe P Un/ ARS Sr CAD 


把 服务 器 修改 为 使 用 多 线程 , 只 需要 对 处 理 消息 进行 修改 即 可 (新 的 代码 行 用 粗 体 标 出 ): 


void process (final Socket socket) { 
if (socket == null) 
return; 


Runnable clientHandler = new Runnable() { 
public void run() ( | 
try { 
System.out.printf("Server: getting messageM"); 
String message = MessageUtils.getMessage (socket); 
System.out.printf("Server: got message: %s\n", message); 
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Thread.sleep(1000); 

System.out.printf("Server: sending reply: %s\n", message); 
MessageUtils.sendMessage(socket, "Processed: ”+ message); 
System.out.printf("Server: sent\n"); 
closelgnoringException (socket); 

catch (Exception e) { 

e.printStackTrace(); 


— 


} 
} 
}; 


Thread clientConnection = new Thread (clientHandler); 
clientConnection.start(); 


) 





ME: 





org.jfree.date.SerialDate 


代码 清单 B-1 SerialDate.Java 


vz H E tz zz zt zg zz sz zs E zz E zz E 


+ + >+ 


* 


————————————— COO 一 
OO ee 一 一 < Li EE 一 一 一 一 we re Sue MEM cur CUP MM GE ee EE arua Meam cu EE ee rw 一 一 GER nn SE ure SE rcm ee E Me ee ze 


a rn ra SS Ee EE E E EE SE E EE SE E E E SE e SE GE SE E E SE E E E Se SE E E E SE SE EE EE SE Ze ZE E ES E 


CG 
e SE Deen SE SE e Ee L Ee SE GE SE Se SE GE GER SC SE SE SE ec ZE Ge SE ge See a vm ge Ge SE SE e E SS E a d wn ze GE SC e vm Em zg Sep zë ze SS SE zë SE SE ZE ze e SE E Se e ze SC SE zm e Ce SE 


(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 
Project Info: http://www.jfree.org/jcommon/index.html 


This library is free software; you can redistribute it and/or modify it 
under the terms of the GNU Lesser General Public License as published by 
the Free Software Foundation; either version 2.1 of the License, or 

(at your option) any later version. 


This library is distributed in the hope that it will be useful, but 
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 
License for more details. 


You should have received a copy of the GNU Lesser General Public 

License along with this library; if not, write to the Free Software 
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 
USA. 


[Java is a trademark or registered trademark of Sun Microsystems, Inc. 
in the United States and other countries.] 


(C) Copyright 2001-2005, by Object Refinery Limited. 
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Original Author: David Gilbert (for Object Refinery Limited); 
Contributor(s): -; 


$Id: SerialDate.java,v 1.7 2005/11/03 09:25:17 mungady Exp $ 


Changes (from 11-Oct-2001) 

11-Oct-2001 ; Re-organised the class and moved it to new package 
com.jrefinery.date (DG); 

05-Nov-2001 : Added a getDescription() method, and eliminated NotableDate 
class (DG); 

12-Nov-2001 : IBD requires setDescription() method, now that NotableDate 
class is gone (DG); Changed getPreviousDayOfWeek(), 
getFollowingDayOfWeek() and getNearestDayOfWeek() to correct 
bugs (DG); ! 

05-Dec-2001 : Fixed bug in SpreadsheetDate class (DG); 

29-May-2002 : Moved the month constants into a separate interface 
(MonthConstants) (DG); 

27-Aug-2002 : Fixed bug in addMonths() method, thanks to N???levka Petr (DG); 

03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

13-Mar-2003 : Implemented Serializable (DG); 

29-May-2003 : Fixed bug in addMonths method (DG); 

04-Sep-2003 : Implemented Comparable. Updated the isInRange jausdocs (DG) ; 

05-Jan-2005 : Fixed bug in addYears() method (1096282) (DG); 


package org.jfree.date; 


import java.io.Serializable; 

import java.text.DateFormatSymbols; 
import java.text.SimpleDateFormat; 

import java.util.Calendar; 

import java.util.GregorianCalendar; 


/** 

* An abstract class that defines our requirements for manipulating dates, 

* without tying down a particular implementation. 

* «p» 

* Requirement 1 : match at least what Excel does for dates; 

* Requirement 2 : class is immutable; 

* «p» 

* Why not just use java.util.Date? We will, when it makes sense. At times, 
* java.util.Date can be *too* precise - it represents an instant in time, 

* accurate to 1/1000th of a second (with the date itself depending on the 

* time-zone). Sometimes we just want to represent a particular day (e.g. 21 
* January 2015) without concerning ourselves about the time of day, or the 
* time-zone, or anything else. That's what we've defined SerialDate for. 

* «p» 

* You can call getInstance() to get a concrete subclass of SerialDate, 

* without worrying about the exact implementation. 

à 

* @author David Gilbert 


85 


附录 B org.jfree.date.SerialDate 329 


86 public abstract class SerialDate implements Comparable, 


87 
88 
89 


Serializable, 
MonthConstants { 


/** For serialization. */ 
private static final long serialVersionUID = -293716040467423637L; 


/** Date format symbols. */ 
public static final DateFormatSymbols 
DATE FORMAT SYMBOLS = new SimpleDateFormat().getDateFormatSymbols(); 


/** The serial number for 1 January 1900. */ 
public static final int SERIAL LOWER BOUND = 2; 


/** The serial number for 31 December 9999. */ 
public static final int SERIAL UPPER BOUND = 2958465; 


/** The lowest year value supported by this date format. */ 
public static final int MINIMUM YEAR SUPPORTED = 1900; 


/** The highest year value supported by this date format. */ 
public static final int MAXIMUM YEAR SUPPORTED = 9999; 


/** Useful constant for Monday. Equivalent to java.util.Calendar.MONDAY. */ 
public static final int MONDAY = Calendar.MONDAY; 


/** 

* Useful constant for Tuesday. Equivalent to java.util.Calendar.TUESDAY. 
ef 
public static final int TUESDAY = Calendar.TUESDAY; 


/** 

* Useful constant for Wednesday. Equivalent to 

* java.util.Calendar.WEDNESDAY. 

WË 

public static final int WEDNESDAY = Calendar. WEDNESDAY. 


/** 

* Useful constant for Thrusday. Equivalent to java.util.Calendar.THURSDAY. 
* / 

public static final int THURSDAY = Calendar.THURSDAY; 


/** Useful constant for Friday. Equivalent to java.util.Calendar. FRIDAY. */ 
public static final int FRIDAY = Calendar.FRIDAY; 


/** 

* Useful constant for Saturday. Equivalent to java.util.Calendar.SATURDAY. 
<7 

public static final int SATURDAY = Calendar.SATURDAY; 


/** Useful constant for Sunday. Equivalent to java.util.Calendar.SUNDAY. */ 
public static final int SUNDAY = Calendar.SUNDAY; 
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/** The number of days in each month in non leap years. */ 
static final int[] LAST DAY OF MONTH - 
(人 31; 28; 31; 30; 31/30; 31, 3L, 30, 91; 30, 31); 


/** The number of days in a (non-leap) year up to the end of each month. */ 
static final int[] AGGREGATE DAYS TO END OF MONTH = 
. (0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365); 


/** The number of days in a year up to the end of the preceding month. */ 
static final int[] AGGREGATE DAYS TO END OF PRECEDING MONTH - | 
(0, 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365); 


/** The number of days in a leap year up to the end of each month. */ 
Static final int[] LEAP YEAR AGGREGATE DAYS TO END OF MONTH - 
(0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366}; 


/** 
* The number of days in a leap year up to the end of the preceding month. 
Vi 
static final int[] 
LEAP YEAR AGGREGATE DAYS TO END OF PRECEDING MONTH = 
(0, 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366); 


/** A useful constant for referring to the first week in a month. */ 
public static final int FIRST WEEK IN MONTH = 1; 


/** A useful constant for referring to the second week in a month. */ 
public static final int SECOND WEEK IN MONTH = 2; 


/** A useful constant for referring to the third week in a month. */ 
public static final int THIRD WEEK IN MONTH = 3; 


/** A useful constant for referring to the fourth week in a month. */ 
public static final int FOURTH WEEK IN MONTH = 4; - 


/** A useful constant for referring to the last week in a month. */ 
public static final int LAST WEEK IN MONTH = 0; 


/** Useful range constant. */ 
public static final int INCLUDE NONE - 0; 


/** Useful range constant. */ 
public static final int INCLUDE FIRST = 1; 


/** Useful range constant. */ 
public static final int INCLUDE SECOND = 2; 


/** Useful range constant. */ 
public static final int INCLUDE BOTH = 3; 


/** 

* Useful constant for specifying a day of the week relative to a fixed 
* date. 

vi 


193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
231 
238 
239 
240 
241 
242 
243 
244 
245 
246 


附录 B org.jfree.date.SerialDate 


H 


public static final int PRECEDING = -1; 

/** i 
* Useful constant for specifying a day of the week relative to a fixed 
* date. 

*/. 

public static final int NEAREST = 0; 


/** 
* Useful constant for specifying a day of the week relative to a fixed 
* date. | 
*/ 

public static final int FOLLOWING = 1; 


/** A description for the date. */ 
private String description; 


/** 
* Default constructor. 
x/ 
protected SerialDate() ( 
) 


/** 

* Returns <code>true</code> if the supplied integer code represents a. 
* valid day-of-the-week, and <code>false</code> otherwise. 

* 


@param code the code being checked for validity. 


* 

* 

* @return <code>true</code> if the supplied integer code represents a 
* valid day-of-the-week, and <code>false</code> otherwise. 

* 


/ 
public static boolean isValidWeekdayCode(final int code) { 


switch(code) { 

case SUNDAY: 
case MONDAY: 
/case TUESDAY: 
case WEDNESDAY: 
case THURSDAY: 
case FRIDAY: 
case SATURDAY: 

return true; 
default: 

return false; 


Converts the supplied string to a day of the week. 


(param S a string representing the day of the week.. 


331 


332 附录 B org.jfree.date.SerialDate 


247 * @return <code>-1</code> if the string is not convertable, the day of 
248 K the week otherwise. 
249. Wi ; 
250 public static int stringToWeekdayCode (String s) { 
251 
252 |. final String[] shortWeekdayNames 
253 | = DATE FORMAT SYMBOLS.getShortWeekdays(); | 
254 final String[] weekDayNames - DATE FORMAT SYMBOLS.getWeekdays(); 
255 
256 int result - -1; 
257 s = s.trim(); 
258 for (int i = 0; i < weekDayNames.length; i++) { 
259 if (s.equals(shortWeekdayNames[il)) { 
260 result = i; 
261 break; 
262 } / 
263 if (s.equals(weekDayNames[i])) { 
264 result = i; 
265 break; 
266 ) 
267 ) 
268 return result; 
269 
270 } 
271 
272 frx 
213 * Returns a string representing the supplied day-of-the-week. 
274 * <P> 
275 * Need to find a better approach. 
276 aj 
277 * @param weekday the day of the week. 
278 * 
279 * @return a string representing the supplied day-of-the-week. 
280 KÉ | 
281 public static String weekdayCodeToString(final int weekday) { 
282 
283 — final String[] weekdays = DATE FORMAT SYMBOLS.getWeekdays(); 
284 - return weekdays [weekday]; 
285. 
286 ) 
287 
288 [** 
289 * Returns an array of month names. 
290 * 
291 * @return an array of month names. 
292 WI ) 
293 public static String[] getMonths() ( 
294 
295 return getMonths(false); 
296 
297 } 
298 ; 
299 fer 


300 * Returns an array of month names. 


附录 B org.jfree.date.SerialDate 333 


301 * 
302 * (param shortened a flag indicating that shortened month names should 
303 * i be returned. 
304 * | 
305 * @return an array of month names. 
306 TES 
307 public static String[] getMonths(final boolean shortened) ( 
308 
309 ^^; if-(shortened) { 
310 return DATE FORMAT SYMBOLS.getShortMonths(); 
311 } 
312 else { 
313 return DATE FORMAT SYMBOLS.getMonths(); 
314 ) 
315 
| 316 )- 
317 
318 ES 
319 * Returns true if the supplied integer code represents a valid month. 
320 x 
321 * (param code the code being checked for validity. 
322 * 
323 * @return <code>true</code> if the supplied integer code represents a 
324 * " valid month. 
325 ES 
326 public static boolean isValidMonthCode(final int code) { 
327 
328 switch(code) { 
329 case JANUARY: 
330 case FEBRUARY: 
331 case MARCH: 
332 case APRIL: 
333 case MAY: 
334 case JUNE: 
335 case JULY: 
336 case AUGUST: INS 
337 case SEPTEMBER: 
338 Case OCTOBER: 
339 case NOVEMBER: o 
340°. case DECEMBER: 
341 | return true; 
342 default: 
343 return false; - 
344 } 
345 
346} Non 
348 EES WU f eee 
349 * Returns the quarter for the specified month. 
350 * i 
351 * @param code the month code (1-12). 
352 mo dei t 
353 * (return the quarter that the month belongs to. 
354 * (throws java.lang.IllegalArgumentException 
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355 xf 

356 public static int monthCodeToQuarter(final int code) { 
357 

358 switch(code) { 

359 case JANUARY: 

360 | case FEBRUARY: 

361 case MARCH: return 1; rus 
362 case APRIL: 
363 case MAY: 

364 case JUNE: return 2; 

365 case JULY: 

366 case AUGUST: 

367 case SEPTEMBER: return 3; ` 

368 case OCTOBER: 

369 case NOVEMBER: 

370 l case DECEMBER: return 4; ! 
371 default: throw new IllegalArgumentException( 

372 "SerialDate.monthCodeToQuarter: invalid month code."); 
373 ) 

374 

375 ) 

376 

377 /** 

378 * Returns a string representing the supplied month. 

379 * <P> 

380 * The string returned is the long form of the month name taken from the 
381 * default locale. 

382 * ii 

383 * @param month the month. 

384 f 

385 * @return a string representing the supplied month. 

386 SA 

387 public static String monthCodeToString(final int month) { 
388 、 | 
389 return monthCodeToString(month, false); 

390 

391 } 

392 

393 E ia: 

394 * Returns a string representing the supplied month. 

395 * «p» | 
396 * The string returned is the long or short form of the month name taken 
397 * from the default locale. | 

398 3 

399 * (iparam month the month. 

400 * @param shortened if <code>true</code> return the abbreviation of the 
401 s month. 

402 * 

403 * @return a string representing the supplied month. 

404 * @throws java.lang.IllegalArgumentException 

405 t 


406 public static String monthCodeToString(final int month, 
407 final boolean shortened) ( 
408 
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// check arguments... 
if (lisValidMonthCode (month)) { 
throw new IllegalArgumentException( 
"SerialDate.monthCodeToString: month outside valid range."); 


) 
final String[] months; 


if (shortened) ( 
months = DATE FORMAT SYMBOLS.getShortMonths(); 
) 
else ( 
months = DATE FORMAT SYMBOLS.getMonths(); 
) 


return months[month - 1]; 


[** E 
Converts a string to a month code. 

«P» l 

This méthod will return one of the constants JANUARY, FEBRUARY, ..., 
DECEMBER that corresponds to the string. If the string is not 
recognised, this method returns -1. 


(param s the string to parse. 


+ + +*+ 000€ 0X HF 外 00€ >+ 


(return «code»-1«/code» if the string is not parseable, the month of the 
year otherwise. 

x / . 

public static int stringToMonthCode(String s) { 


final String[] shortMonthNames = DATE FORMAT SYMBOLS.getShortMonths(); 
final String[] monthNames = DATE FORMAT SYMBOLS.getMonths(); | 


int result = -1; 
S = S.trim(); 


// first try parsing the string as an integer (1-12);;: 
try ( l l 
result = Integer.parseInt(s); 
} | 
catch (NumberFormatException e) { > 
// suppress 
) 


// now search through the month names... 
if ((result « 1) || (result > 12)) ( 
for (int i = 0; i < monthNames.length; i++) { 
if (s.equals(shortMonthNames[i])) { 
result = i + 1; 
break; 
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) 
/** 


* Returns true if the supplied integer code represents a valid 
* week-in-the-month, and false otherwise. 


* 
* 
* 
* 


rh 


public static boolean isValidWeekInMonthCode(final int code) { 


) 


if (s.equals(monthNames(i])) { 
result = i + 1; 


break; 


return result; 


@param code the codé being checked for validity. 
@return <code>true</code> if the supplied integer code represents a 
valid week-in-the-month. 


switch(code) ( 


/** 


case FIRST WEEK IN MONTH: 
case SECOND WEEK IN MONTH: 
case THIRD, WEEK, IN, MONTH: 
cáse FOURTH WEEK IN. MONTH: 
case LAST WEEK IN MONTH: return true; 


default: return false; 


H 


* Determines whether or not the specified year is a leap year. 


* 
* 
* 
* 


KI 


public Static boolean isLeapYear(final int yyyy) { 


@param yyyy the year (in the range 1900 to 9999). 


(return <code>true</code> if the specified year is a leap year. 


if ((yyyy $ 4) != 0) { 


) 


return false; 


else if ((yyyy % 400) 


) 


return true; 


else if ((yyyy % 100) 


) 


return false; 


else { 


) 


return true; 
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/** 

Returns the number of leap years from 1900 to the specified year | 
INCLUSIVE. 

<P> 

Note that 1900 is not a leap year. 


@param yyyy the year (in the range 1900 to 9999). 


t+ + + + + 4% oot ox 


@return the number of leap years from 1900 to the specified year. 
a 
public static int leapYearCount(final int yyyy) { 


final int leap4 = (yyyy - 1896) / 4; 
final int leap100 = (yyyy ~ 1800) / 100; 
final int leap400 = (yyyy - 1600) / 400; 
return leap4 - leap100 + leap400; 


/** 
* Returns the number of the last day of the month, taking into account 
* leap years. 
* 
* (param month the month. 
* (param yyyy the year (in the range 1900 to 9999). 
* 
* (ireturn the number of the last day of the month. 
ici 
public static int lastDayOfMonth(final int month, final int yyyy) ( 


final int result = LAST DAY OF MONTH [month]; 
if (month != FEBRUARY) { 
return result; 
} 
else if (isLeapYear(yyyy)) ( 
return result * 1; 
) 
else { 
return result; 


* Creates a new date by adding the specified number of days to the base 
* date. 
* 
* 


(param days the number of days to add (can be negative). 
* (iparam base the base date. 
* 
* @return a new date. 


*/ 
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571 public static SerialDate dddDays(final int days, final SerialDate base) { 


572 

573 final int serialDayNumber = base.toSerial() + days; 

574 return SerialDate.createInstance(serialDayNumber); 

575 

576 ) 

577 

578 fee 

579 * Creates a new date by adding the specified number of months to the pase 
580 * date. 

581 * <P> 

582 * If the base date is close to the end of the month, the dao on the result 
583 * may be adjusted slightly: 31 May * 1 month - 30 June. 

584 x 

585 * (iparam months the number of months to add (can be a dco 

586 * (iparam base the base date. MEE , 

587 * 

588 * @return a new date. 

589 wi 

590 public static SerialDate addMonths(final int months, 

591 final SerialDate base) { 

592 

593 final int yy - ^s * base.getYYYY() * base.getMonth() * months - 1) 
594 / 1 

595 final int mm - Sé * base.getYYYY() + base.getMonth() + months - 1) 
596 $ 12 * 1; 

597 final int dd = Math.min( 

598 base.getDayOfMonth(), SerialDate.lastDayOfMonth (mm, yy) 

599 ); 

600 return SerialDate. DEER mm, yy); 

601 

602 } 

603 

604 yt | 

605 * Creates a new date by adding the specified number of years to the base 
606 * date. | 

607 S 

608 * (param years the number of years to add (can be negative). 

609 * (iparam base the base date. 

610 * 

611 * (return A new date. 

612 Ty 

613 public static SerialDate addYears(final int years, final SerialDate base) { 
614 

615 final int baseY = base.getYYYY () ; 

616 final int baseM = base.getMonth(); 

617 final int baseD = base.getDayOfMonth(); 

618 | 

619 final int targetY = baseY + years; 

620 final int targetD = Math.min( 

621 baseD, SerialDate. lastDayOfMonth (baseM, targetY) 

622 ); 

623 


624 return SerialDate.createInstance(targetD, baseM, targetY); 
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* Returns the latest date that falls on the specified day-of-the-week and 
* is BEFORE the base date. 


(param targetWeekday a code for the target day-of-the-week. 
(param base the base date. 


Qreturn the latest date that falls on the specified day-of-the-week and 
is BEFORE the base date. 


public static SerialDate getPreviousDayOfWeek (final int targetWeekday, 
final SerialDate base) ( 


// check arguments.. 
if (!SerialDate. i sValidWeekdayCode (targetWeekday) ) { 
throw new IllegalArgumentException ( 
"Invalid day-of-the-week code." 
); 
) 


// find the date... 
final int adjust; 
final int baseDOW = base.getDayOfWeek(); 
if (baseDOW > targetWeekday) { 
adjust = Math.min(0, targetWeekday - baseDOW); 
) 
else { 
adjust = -7 + Math.max(0, targetWeekday - baseDOW); 


) 


return SerialDate.addDays (adjust, base); 


/** | | 
* Returns the earliest date that falls on the specified day-of-the-week 
and is AFTER the base date. 


* 

* 

* (param targetWeekday a code for the target Ger -the-week. 
* (param base the base date. 

* 
* 
* 


(return the earliest date that falls on the specified day-of-the-week 
~ and is AFTER the base date. 
Vi 
public static SerialDate getFollowingDayOfWeek(final int targetWeekday, 
final SerialDate base) { 


// check arguments... 
if (!SerialDate.isValidWeekdayCode (targetWeekday)) { 
throw new IllegalArgumentException( 
"Invalid day-of-the-week code." 
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679 ) ; 

680 ) 

681 

682 // find the date... 

683 final int adjust; 

684 final int baseDOW - base.getDayOfWeek(); 

685 - . if (baseDOW > targetWeekday) { | 

686 adjust = 7 + Math.min(0, targetWeekday - baseDOW); 
687 ) 

688 else ( | 

689 adjust = Math.max(0, targetWeekday - baseDOW); 

690 } 

691 

692 return SerialDate.addDays (adjust, base); 

693 E 

694 : 
695 [ts 

696 * Returns the date that falls on the specified day-of-the-week and is 
697 * CLOSEST to the base date. 

698 x. 

699 * (iparam targetDOW a code for the target day-of-the-week. 
700 * @param base the base date. 

701 * 

702 * @return the date that falls on the specified day-of-the-week and is 
703 * CLOSEST to the hase date. 

104 */ 

705 public static SerialDate getNearestDayOfWeek(final int targetDOW, 
706 final SerialDate base) ( 
707 

708 // check arguments... 

709 if (!SerialDate.isValidWeekdayCode (targetDOW)) ( 

710 throw new IllegalArgumentException( 

711 "Invalid day-of-the-week code." 

712 ); 

713 ) 

714 

715 // find the date... 

716 final int baseDOW = base.getDayOfWeek(); 

717 int adjust = -Math.abs(targetDOW - baseDOW); 

718 if (adjust >= 4) { 

719 adjust = 7 - adjust; 

720 } ` 

721 if (adjust <= -4) { 

722 adjust = 7 + adjust; 

723 ) 

724 return SerialDate.addDays (adjust, base); 

725 

726 } 

727 

728 Lä 

729 * Rolls the date forward to the last day of the month. 

130 * 

731 * @param base the base date. 


7132 , 
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733 * (return a new serial date. 

734 */ 

735 public SerialDate getEndOfCurrentMonth(final SerialDate base) ( 

736 = final int last = SerialDate.lastDayOfMonth( 

731 base.getMonth(), base.getYYYY () 

738 ); ; 

739 return SerialDate.createInstance(last, base.getMonth(), base.getYYYY ()); 
740 } 

741 

742 /** 

743 * Returns a string corresponding to the week-in-the-month code. 
744 * «p» 

745 * Need to find a better approach, 

746 * 

747 * @param count an integer code representing the week-in-the-month. 
748 * l 
749 * @return a string corresponding to the week-in-the-month code. 
750 Wi i | 


751 public static String weekInMonthToString(final int count) { 
752 | 


753 switch (count) { 

754 case SerialDate.FIRST WEEK IN MONTH : return "First"; 
755 case SerialDate,SECOND WEEK IN MONTH ; return "Second"; 
756 case SerialDate.THIRD_WEEK_IN_MONTH : return "Third"; 
757 case SerialDate.FOURTH WEEK IN MONTH : return "Fourth"; 
758 case SerialDate.LAST WEEK IN, MONTH : return "Last"; 
759 default : 

760 return "SerialDate.weekInMonthToString(): invalid code."; 
761 ) | 

762 

763 } 

764 

765 /** 

766 * Returns a string representing the supplied 'relative'. 

767 * <P> 

768 * Need to find a better approach. 

769 * 

770 * @param relative a constant representing the 'relative'. 
771 * . 

772 * @return a string representing the supplied 'relative'. 

713 */ 


774 public static String relativeToString(final int relative) { 
775 


776 switch (relative) { 

777 case SerialDate.PRECEDING : return "Preceding"; 
778 case SerialDate.NEAREST : return "Nearest"; 

779 case SerialDate.FOLLOWING : return "Following"; 
780 default : return "ERROR : Relative To String"; 
781 ) 

782 

783 

784 

785 /** 


786 * Factory method that returns an instance of some concrete subclass of | 
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{@link SerialDate). 











787 * 

788 x 

789 * (iparam day the day (1-31). 

790 * @param month the month (1-12). 

791 * fiparam yyyy the year (in the range 1900 to 9999). 

792 * 

793 * (return An instance of {@link SerialDate}. 

794 SZ ' | 

795 public static SerialDate createInstance(final int day, final int month, 

796 final int yyyy) ( 

797 return new SpreadsheetDate (day, month, yyyy); 

798 ) 

799 

800 /** 

801 * Factory method that returns an instance of some concrete subclass of 

802 * (link SerialDate}. : 

803 * j i 

804 * @param serial the serial number for the day (1 January 1900 = 2). 

805 is 

806 * @return a instance of SerialDate. 

807 */ 

808 public static SerialDate createInstance(final int serial) ( 

809 return new SpreadsheetDate (serial); 

810 ) : 

811 

812 P dia 

813 * Factory method that returns an instance of a subclass of SerialDate. 

814 * 

815 * (iparam date A Java date object. 

816 * 

817 * @return a instance of SerialDate. 

818 WI 

819 public static SerialDate createInstance(final java.util.Date date) ( E 
820 | p 
821 final GregorianCalendar calendar = new GregorianCalendar(); ^" 
822 calendar.setTime (date); | E 
823 return new SpreadsheetDate (calendar.get(Calendar.DATE), A 
824 . calendar.get(Calendar.MONTH) + 1, 
825 calendar.get (Calendar.YEAR) ) ; 
826 . | E 
827 ) ` 
829 /** 

830 * Returns the serial number for the date, where 1 January 1900 = 2 (this 

831 * corresponds, almost, to the numbering system used in Microsoft Excel for 

832 * Windows and Lotus 1-2-3). 

833 * 

834 * @return the serial number for the date. 

835 x 

836 public abstract int toSerial(); 

837 

838 [5*5 

839 * Returns a java.util.Date. Since java.util.Date has more precision than 


840 * SerialDate, we need to define a convention for the 'time of day'. 
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* 


* (return this as «code»java.util.Date«/code». 
*/ 
public abstract java.util.Date toDate(); 


/** 


* Returns a description of the date. 
* 


* (return a description of the date. 

KI 

public String getDescription() { 
return this.description; 


) 


/** 
* Sets the description for the date. 
* 


* (iparam description the new description for the date. 

x. / | 

public void setDescription(final String description) { 
this.description = description; 


) 
/** 


* Converts the date to a string. 
* 


* @return a string representation of the date. 


ST 
public String toString() { 
return getDayOfMonth() + "-" + SerialDate.monthCodeToString(getMonth () ) 
+ "~" + getYYYY(); 
) 
/** 


* Returns the year (assume a valid range of 1900 to 9999). 
* 


* @return the year. 
x / 
public abstract int getYYYY(); 


/** 
* Returns the month (January = 1, February = 2, March = 3). 
* 


* @return the month of the year. 
*/ 
public abstract int getMonth(); 


/** 
* Returns the day of the month. 
* 


* (return the day of the month. 
a 
public abstract int getDayOfMonth(); 
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895 TSX 

896 * Returns the day of the week. 

897 * 

898 * @return the day of the week. 

899 JAN 

900 public abstract int getDayOfWeek(); 

901 ' 

902 [tx 

903 * Returns the difference (in days) between this date and the specified 
904 * 'other' date. 

905 * «p» 

906 * The result is positive if this date is after the 'other' date and 
907 * negative if it is before the 'other' date. 

908 * 

909 * (param other the date being compared to. 

910 : 

911 * @return the difference between this and the other date. 

912 */ 

913 public abstract int compare(SerialDate other); 

914 

915 [xs 

916 * Returns true if this SerialDate represents the same date as the 
917 * specified SerialDate. 

918 * 

919 * (iparam other the date being compared to. 

920 * | 

921 * @return <code>true</code> if this SerialDate represents the same date as 
922 i the specified SerialDate. 

923 wi 

924 public abstract boolean isOn(SerialDate other); 

925 

926 yee 

927 * Returns true if this SerialDate represents an earlier date compared to 
928 * the specified SerialDate. 
929 * 

930 * @param other The date being compared to. 

931 * 

932 * Qreturn “code>true</code> if this SerialDate represents an earlier date 
933 * compared to the specified SerialDate. 

934 id 

935 public abstract boolean isBefore(SerialDate other); 

936 

937] /** 

938 * Returns true if this SerialDate represents the same date as the 
939 * specified SerialDate. 

940 * 

941 * (param other the date being compared to. 
| 942 Eos 

943 * @return <code>true<code> if this SerialDate represents the same date 
944 * as the specified SerialDate. 

945 */ 

946 public abstract boolean isOnOrBefore(SerialDate other); 

947 


948 / 
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949 * Returns true if this SerialDate represents the same date as the 
950 * specified SerialDate. 

951 * 

952 * (iparam other the date being compared to. 

953 * 

954 * (return <code>true</code> if this SerialDate represents the same date 
955 * as the specified SerialDate. 

956 */ 

9577 public abstract boolean isAfter(SerialDate other); 

958 

959 [** 

960 * Returns true if this SerialDate represents the same date as the 
961 * specified SerialDate. 

962 * | 

963 * (param other the date being compared to. 

964 * | 

965 ` * @return <code>true</code> if this SerialDate represents the same date 
966 * as the specified SerialDate, 

967 "EZ | 

968 public abstract boolean isOnOrAfter(SerialDate other); 

969 | 

970 /** 

971 * Returns <code>true</code> if this {@link SerialDate} is within the 
972 * specified range (INCLUSIVE). The date order of dl and d2 is not 
973 * important. 

974 * 

975 * (param dl a boundary date for the range. 

976 * (iparam d2 the other boundary date for the range. 

977 * 

978 * Qreturn A boolean. 

979 */ 


980 public abstract boolean isInRange(SerialDate dl, SerialDate d2); 
981 


982 /** 

983 * Returns <code>true</code> if this {@link SerialDate) is within the 
984 * specified range (caller specifies whether or not the end-points are 
985 * included). The date order of dl and d2 is not important. 

986 * 

987 * (param dl a boundary date for the range. 

988 * (param d2 the other boundary date for the range. 

989 * (param include a code that controls whether or not the start and end 
990 z dates are included in the range. 

991 * 

992 * @return A boolean. 

993 ET 

994 public abstract boolean isInRange(SerialDate dl, SerialDate d2, 

995 int include); 

996 

997 /** " 

998 * Returns the latest date that falls on the specified day-of-the-week and 
999 * is BEFORE this date. 

1000 * 

1001 * (param targetDOW a code for the target day-of-the-week. 

1002 7 
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1003 * @return the latest date that falls on the specified day-of-the-week and 
1004 * is BEFORE this date. 

1005 * 

1006 public SerialDate getPreviousDayOfWeek(final int targetDOW) ( 

1007 return getPreviousDayOfWeek(targetDOW, this); 

1008 ) 

1009 

1010. . /** | 
1011 * Returns the earliest date that falls on the specified day-of-the-week 
1012 * and is AFTER this date. 

1013 x 

1014 * (param targetDOW a code for the target day-of-the-week. 

1015 i 

1016 * @return the earliest date that falls on the aero” ES of-the-week 
1017 * and, is AFTER this date. : . 
1018 */ | 

1019 public SerialDate getFollowingDayOfWeek(final int targetDOW) ( 

1020 return getFollowingDayOfWeek(targetDOW, this); 

1021 ) 

1022 

1023 /** 

1024 * Returns the nearest date that falls on the specified day-of-the-week. 
1025 x 

1026 * @param targetDOW a code for the target day-of-the-week. 

1027 * 

1028 * @return the nearest date that falls on the specified day-of-the-week. 
1029 ei 

1030 public SerialDate getNearestDayOfWeek(final int targetDOW) { 

1031 return getNearestDayOfWeek(targetDOW, this); 

1032 } | 

1033 

1034 } 
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2 * JCommon : a free general purpose class library for the Java(tm) platform 
* Z33323 


(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 
Project Info: http://www.jfree.org/jcommon/index.html 


This library is free software; you can redistribute it and/or modify it 
under the terms of the GNU Lesser General Public License as published by 
the Free Software Foundation; either version 2.1 of the Dicens or 

(at your option) any later version. 


This library is distributed in the hope that it will be useful, but 
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 
License for more details. 
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You should have received a copy of the GNU Lesser General Public 
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License along with this library; if not, write to the Free Software 
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 
USA. 


[Java is a trademark or registered trademark of Sun Microsystems, Inc. 
in the United States and other countries.] 
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package org. 


import 
import 
import 
import 
import 
import 


import 
import 


import 


import 
import 


/** 


Changes 


15-Nov-2001 : 
25-Jun-2002 
24-Oct-2002 : 
13-Mar-2003 
05-Jan-2005 


java. 
java. 
java. 
java. 
java. 
java. 


(C) Copyright 2001-2005, by Object Refinery Limited. 


Original Author: David Gilbert (for Object Refinery Limited) ; 
Contributor(s): -; 


$Id: SerialDateTests.java,v 1.6 2005/11/16 15:58:40 taqua Exp $ 


Version 1 (DG); 

: Removed unnecessary import (DG); 

Fixed errors reported by Checkstyle (DG); 
: Added serialization test (DG); 

: Added test for bug report 1096282 (DG); 


jfree.date.junit; 


io. 
io. 
io. 
.ObjectInputStream; 
.ObjectOutput; 

io. 


io 
io 


ByteArrayInputStream; 
ByteArrayOutputStream; 
ObjectInput; 


ObjectOutputStream; 


junit.framework.Test; 
jupnit.framework.TestCase; 
junit.framework.TestSuite; 


org.jfree.date.MonthConstants; 
org.jfree.date.SerialDate; 


* Some JUnit tests for the {@link SerialDate) class. 


*/ 


public class SerialDateTests extends TestCase { 


/** Date representing November 9. */ 
private SerialDate nov9Y2001; 


/** 


* Creates a new test case. 


* 
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127 


: * (param name the name. 


Si = 
public SerialDateTests (final String name) { 
super (name) ; 


} 
HI 


* Returns a test suite for the JUnit test runner. 
* 
* (return The test suite. 
*/ 
public static Test suite() { 
return new TestSuite(SerialDateTests.class); 


) 


IO 
* Problem set up. 
ad 
protected void setUp() { 

this.nov9Y2001 = SerialDate.createInstance(9, MonthConstants.NOVEMBER, 2001); 
} 


/** 

* 9 Nov 2001 plus two months should be 9 Jan 2002. 

*/ 

public void testAddMonthsTo9Nov2001() ( 
final SerialDate jan9Y2002 = SerialDate.addMonths(2, this.nov9Y2001); 
final SerialDate answer = SerialDate.createInstance(9, 1, 2002); 
assertEquals (answer, jan9Y2002); 


/** 

* A test case for a reported bug, now fixed. 

i 

public void testAddMonthsTo50ct2003() { 
final SerialDate dl = SerialDate.createInstance (5, MonthConstants.OCTOBER, 2003) ; 
final SerialDate d2 = SerialDate.addMonths(2, dl); 
assertEquals(d2, SerialDate.createInstance (5, MonthConstants.DECEMBER, 2003)); 

) 


/** 
* A test case for a reported bug, now fixed. 
x/ 
public void testAddMonthsTolJan2003() { 
final SerialDate dl = SerialDate.createInstance(1, MonthConstants.JANUARY, 2003); 
final SerialDate d2 = SerialDate.addMonths(0, dl); 
assertEquals(d2, dl); 
) 


/** 
* Monday preceding Friday 9 November 2001 should be 5 November. 
Sf 
public void testMondayPrecedingFriday9Nov2001() ( 
SerialDate mondayBefore = SerialDate.getPreviousDayOfWeek ( 
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SerialDate.MONDAY, this.nov9Y2001 
); | 

assertEquals (5, mondayBefore.getDayOfMonth ()); 
) 


/** | | . 

* Monday following Friday 9 November 2001 should be 12 November. 

*/ 

public void testMondayFollowingFriday9Nov2001() {. 

SerialDate mondayAfter = SerialDate.getFollowingDayOfWeek( 
SerialDate.MONDAY, this.nov9Y2001 

); 

assertEquals(12, mondayAfter.getDayOfMonth()); 

} . 


fae | 
* Monday nearest Friday 9 November 2001 should be 12 November. 
*/ 
public void testMondayNearestFriday9Nov2001() { 
SerialDate mondayNearest = SerialDate.getNearestDayOfWeek ( 
SerialDate.MONDAY, this.nov9Y2001 
); 
assertEquals(12, mondayNearest.getDayOfMonth()); 
) 


/** 
* The Monday nearest to 22nd January 1970 falls on the 19th. 
* / 5 
public void testMondayNearest22Jan1970() ( 
SerialDate jan22Y1970 = SerialDate.createInstance 
(22, MonthConstants.JANUARY, 1970); 
SerialDate mondayNearest-SerialDate.getNearestDayOfWeek 
(SerialDate.MONDAY, jan22Y1970); 
assertEquals(19, mondayNearest.getDayOfMontn()); 
) 


/** 


* Problem that the conversion of days to strings returns the right result. 


* Actually, this 

* result depends on the Locale so this test needs to be modified. 
wi 

public void testWeekdayCodeToString() { 


final String test = SerialDate.weekdayCodeToString (SerialDate.SATURDAY); 


assertEquals ("Saturday", test); 


} 


/** 

* Test the conversion of a string to a weekday. Note that this test will 
fail if the | 

* default locale doesn't use English weekday names...devise a better test! 

St 

public void testStringToWeekday() { 
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178 A 

179 int weekday = SerialDate.stringToWeekdayCode ("Wednesday"); 

180 assertEquals (SerialDate.WEDNESDAY, weekday); 

181 . 

182 weekday = SerialDate.stringToWeekdayCode(" Wednesday "); 

183 assertEquals (SerialDate.WEDNESDAY, weekday); 

184 i 

185 |» weekday = SerialDate.stringToWeekdayCode ("Wed"); 

186 assertEquals (SerialDate.WEDNESDAY, weekday); 

187 | | l 

188 } 

189 

190 [** 

191 * Test the conversion of a string to a month. Note that this test will 
fail if the 

192 * default locale doesn't use English month names...devise 3 better test! 

193 Wi 

194 public void testStringToMonthCode() | 

195: 

196 int m = SerialDate.stringToMonthCode ("January"); 

197 assertEquals (MonthConstants.JANUARY, m); 

198 

199 m = SerialDate.stringToMonthCode(" January "); 

200 assertEquals (MonthConstants.JANUARY, m); 

201 

202 m = SerialDate.stringToMonthCode ("Jan"); 

203 assertEquals (MonthConstants.JANUARY, m); 

204 

205 ) 

206 

207 [ax 

208 * Tests the conversion of a month code to a string. 

209 *7 

210 public void testMonthCodeToStringCode() { 

211 ; 

212 final String test = SerialDate.monthCodeToString (MonthConstants . DECEMBERR) ; 

213 assertEquals ("December", test); 

214 

215 } 

216 

217 /** 

218 * 1900 is not a leap year. 

219 x7 

220 public void testIsNotLeapYear1900() { 

221 assertTrue(!SerialDate.isLeapYear(1900)); 

222 ) 

223 

224 /** 

225 * 2000 is a leap year. 

226 */ 

227 public void testIsLeapYear2000() { 

228 assertTrue (SerialDate.isLeapYear (2000) ); 

229 } 
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/** 
* The number of leap years from 1900 up-to-and-including 1899 is 0. 
* / l 
public void testLeapYearCount1899() { | 
assertEquals (SerialDate.leapYearCount (1899), 0); 
} 


/** 
* The number of leap years from 1900 up-to-and-including 1903 is 0. 
*/ 
public void testLeapYearCount1903() { 
assertEquals (SerialDate.leapYearCount (1903), 0); 
) 


/** 
* The number of leap years from 1900 up-to-and-including 1904 is 1. 
vi 
public void testLeapYearCount1904() { 
assertEquals (SerialDate.leapYearCount(1904), 1); 


] 


WI 
* The number of leap years from 1900 up-to-and-including 1999 is 24. 
xj 

public void testLeapYearCount1999() ( 

assertEquals (SerialDate.leapYearCount(1999), 24); 

) 


[= 
* The number of leap years from 1900 up-to-and-including 2000 is 25. 
vi 
public void testLeapYearCount2000() { 

assertEquals (SerialDate.leapYearCount (2000), 25); 


) 
/** 


* Serialize an instance, restore it, and check for equality. 
*/ " 
public void testSerialization() ( 


SerialDate dl = SerialDate.createInstance(15, 4, 2000); 
SerialDate d2 null; 


try { 
ByteArrayOutputStream buffer = new ByteArrayOutputStream(); 
ObjectOutput out = new ObjectOutputStream (buffer); 
out.writeObject (dl); 
out.close(); 


ObjectInput in = new ObjectInputStream 
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(new ByteArrayInputStream(buffer.toByteArray())); 


d2 = (SerialDate) in.readObject(); 
in.close(); 
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322 ) 


catch (Exception e) ( 
System.out.println(e.toString()); 


) 
assertEquals (d1, d2); 


} 


/** 

* A test for bug report 1096282 (now fixed). 

i 

public void test1096282() { 
SerialDate d = SerialDate. cet taobao 2, 2004); 
d » SerialDate.addYears(1, d); 
SerialDate expected = SerialDate.createInstance(28, 2, 2005); 
assertTrue (d.isOn (expected) ) ; 


) 


/** 
* Miscellaneous tests for the addMonths() method. 
*/ 
public void testAddMonths() { 
SerialDate dl = SerialDate.createInstance(31, 5, 2004); 


SerialDate d2 = SerialDate.addMonths (1, dl); 
assertEquals(30, d2.getDayOfMonth()); 
assertEquals(6, d2.getMonth()); 
assertEquals(2004, d2.getYYYY()); 


SerialDate d3 = SerialDate.addMonths(2, dl); 
assertEquals (31, d3.getDayOfMonth()); 
assertEquals (7, d3.getMonth()); 

assertEquals (2004, d3.getYYYY()); 


SerialDate d4 = SerialDate.addMonths (1, SerialDate. ARANOREN; d1)); 
assertEquals(30, d4.getDayOfMonth()); 
assertEquals(7, d4.getMonth()); 
assertEquals(2004, d4.getYYYY()); 
) 
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(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 
Project Info: http://www.jfree.org/jcommon/index.html 


This library is free software; you can redistribute it and/or modify it 
under the terms of the GNU Lesser General Public License as published by 
the Free Software Foundation; either version 2.1 of the License, or 

(at your option) any later version. 
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* 

* This library is distributed in the hope that it will be useful, but 

* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 
* License for more details. 

* 

* You should have received a copy of the GNU Lesser General Public 

* License along with this library; if not, write to the Free Software 

* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 
* USA. 

* ， 

* [Java is a trademark or registered trademark of Sun Microsystems, Inc. 
* in the United States and other countries.] 

* 

E i a a ee a ks ——— 

* MonthConstants. java 

ee 

* (C) Copyright 2002, 2003, by Object Refinery Limited. 

* 

* Original Author: David Gilbert (for Object Refinery Limited); 

* Contributor(s): -; 

* . 

* $Id: MonthConstants.java,v 1.4 2005/11/16 15:58:40 taqua Exp $ 

* 

* Changes 

Fe ee ee ae 

* 29-May-2002 : Version 1 (code moved from SerialDate class) (DG); 

: | 

ef 

package org.jfree.date; 

/** 

* Useful constants for months. Note that these are NOT equivalent to the 
* constants defined by java.util.Calendar (where JANUARY-0 and DECEMBER-11). 
* «p» 

* Used by the SerialDate and RegularTimePeriod classes. 

* 

* (author David Gilbert 

*j 

public interface MonthConstants { 


/** Constant for January. */ 
public static final int JANUARY = 1; 


/** Constant for February. */ 
public static final int FEBRUARY - 2; 


/** Constant for March. */ 


public static final int MARCH = 3; 
/** Constant for April. */ 
public static final int APRIL = 4; 
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67 /** Constant for May. */ 
68 public static final int MAY = 5; 


69 

70 | /** Constant for June. */ 

71 public static final int JUNE - 6; 
72 | 

73 /** Constant for July. */ 

74 public static final int JULY = 7; 


75 

76 ^ /** Constant for August. */ 

77 public static final int AUGUST = 8; 

78 | : 

79 /** Constant for September. */ 

80 public static final int SEPTEMBER = 9; 
81 ` 

82 /** Constant for October. */ 

83 public static final int OCTOBER = 10; 
84 

85 /** Constant for November. */ 

86 public static final int NOVEMBER - 11; 
87 

88 /** Constant for December. */ 

89 public static final int DECEMBER 
90 

91 ) 
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代码 清单 B-4 BobsSerialDateTest.java 


1 package org.jfree.date.junit; 


2 
3 import junit.framework.TestCase; 

4 import org.jfree.date.*; 

5 import static org.jfree.date.SerialDate.*; 
6 

7 

8 


import java.util.*; 
9 public class BobsSerialDateTest extends TestCase ( 


11 public void testIsValidWeekdayCode() throws Exception { 
12 for (int day = 1; day <= 7; daytt) 

13 assertTrue(isValidWeekdayCode (day)); 

14 assertFalse(isValidWeekdayCode (0)); 

15 assertFalse (isValidWeekdayCode (8)); 


16 ) 

17 | 
18 public void testStringToWeekdayCode() throws Exception { 
19 


20 assertEquals(-1, stringToWeekdayCode ("Hello")); 

21 assertEquals (MONDAY, stringToWeekdayCode ("Monday")); 

22 assertEquals (MONDAY, stringToWeekdayCode ("Mon")); 

23 //todo assertEquals (MONDAY, stringToWeekdayCode ("monday") ) ; 
24 // assertEquals (MONDAY, stringToWeekdayCode ("MONDAY")) ; 

25 // assertEquals (MONDAY, stringToWeekdayCode ("mon")); 
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27 assertEquals (TUESDAY, stringToWeekdayCode ("Tuesday") ) ; 

28 assertEquals (TUESDAY, stringToWeekdayCode ("Tue") ); 

29 // assertEquals (TUESDAY, stringToWeekdayCode ("tuesday") ) ; 
30 // assertEquals (TUESDAY, stringToWeekdayCode ("TUESDAY") ) ; 
31 // assertEquals (TUESDAY, stringToWeekdayCode ("tue") ) ; 

32 // assertEquals (TUESDAY, stringToWeekdayCode ("tues") ) ; 

33 

34 assertEquals (WEDNESDAY, stringToWeekdayCode ("Wednesday") ) ; 
35 assertEquals (WEDNESDAY, stringToWeekdayCode ("Wed") ) ; 

36 // assertEquals (WEDNESDAY, stringToWeekdayCode ("wednesday") ) ; 
37 // assertEquals (WEDNESDAY, stringToWeekdayCode ("WEDNESDAY") ) ; 
38 // assertEquals (WEDNESDAY, stringToWeekdayCode ("wed")); 

39 

40 assertEquals (THURSDAY, stringToWeekdayCode ("Thursday")); 

| 41 assertEquals (THURSDAY, stringToWeekdayCode ("Thu")); 

42 // assertEquals (THURSDAY, st ringToWeekdayCode ("thursday")); 
43 // assertEquals (THURSDAY, stringToWeekdayCode ("THURSDAY") ) ; 
44 // assertEquals (THURSDAY, stringToWeekdayCode ("thu")); 

45 // ‘assertEquals (THURSDAY, stringToWeekdayCode ("thurs")); 
46 ) 

47 assertEquals (FRIDAY, stringToWeekdayCode ("Friday")); 

48 assertEquals (FRIDAY, stringToWeekdayCode ("Fri")); 

49 // assertEquals (FRIDAY, stringToWeekdayCode ("friday") ); 

50 // assertEquals (FRIDAY, stringToWeekdayCode ("FRIDAY") ) ; 
51.77 assertEquals (FRIDAY, stringToWeekdayCode ("fri")); 

52 

53 assertEquals (SATURDAY, stringToWeekdayCode ("Saturday")); 
54 assertEquals (SATURDAY, stringToWeekdayCode ("Sat")) ; 

55 // assertEquals (SATURDAY, stringToWeekdayCode ("Saturday") ) ; 
56 // assertEquals (SATURDAY, stringToWeekdayCode ("SATURDAY") ) ; 
57 // assertEquals (SATURDAY, stringToWeekdayCode ("sat")); 

58 

59 assertEquals (SUNDAY, stringToWeekdayCode ("Sunday")); 

60 assertEquals (SUNDAY, stringToWeekdayCode ("Sun")); 

61 // assertEquals (SUNDAY, stringToWeekdayCode ("sunday") ) ; 

62 // assertEquals (SUNDAY,stringToWeekdayCode ("SUNDAY") ) ; 

63 // assertEquals (SUNDAY, stringToWeekdayCode ("sun")); 

64 } 

65 

66 public void testWeekdayCodeToString() throws Exception { 

67 assertEquals ("Sunday", weekdayCodeToString (SUNDAY) ) ; 

68 assertEquals ("Monday", weekdayCodeToString (MONDAY) ) ; 

69 assertEquals ("Tuesday", weekdayCodeToString (TUESDAY) ) ; 

70 assertEquals ("Wednesday", weekdayCodeToString (WEDNESDAY) ) ; 
71 assertEquals ("Thursday", weàkdayCodeToString (THURSDAY) ) ; 
72 assertEquals ("Friday", .weekdayCodeToString (FRIDAY) ) ; 

73 assertEquals ("Saturday", weekdayCodeToString (SATURDAY) ) ; 


74  ) 

75 

76 public void testIsValidMonthCode() throws Exception { 
71 for (inti = 1; i <= 12; itt) 

78 assertTrue(isValidMonthCode(i)); 


79 assertFalse(isValidMonthCode(0)); 
80 assertFalse(isValidMonthCode(13)); 
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81 } 

82 

83 public void testMonthToQuarter() throws Exception { 
84 assertEquals (1, monthCodeToQuarter (JANUARY) ) ; 
85 assertEquals(1, monthCodeToQuarter (FEBRUARY) ) ， 
86 assertEquals(1, monthCodeToQuarter (MARCH) ) ; 

87 assertEquals(2, monthCodeToQuarter (APRIL)) ; 

88 assertEquals(2, monthCodeToQuarter (MAY) ) 

89 assertEquals(2, monthCodeToQuarter (JUNE) ) ; 

90 assertEquals(3, monthCodeToQuarter (JULY)); 

91 assertEquals (3, monthCodeToQuarter (AUGUST) ) ; 

92 assertEquals(3, monthCodeToQuarter (SEPTEMBER) ) ; 
93 assertEquals (4, monthCodeToQuarter (OCTOBER) ) ; 
94 assertEquals (4, monthCodeToQuarter (NOVEMBER) ) ; 
95 assertEquals (4, monthCodeToQuarter (DECEMBER) ) ; 


96 

97 try { 

98 monthCodeToQuarter (-1) ; 

99 fail("Invalid Month Code should throw exception"); 
100 } catch (IllegalArgumentException e) { 

101 } 

102 } 

103 

104 public void testMonthCodeToString() throws Exception { 
105 assertEquals ("January", monthCodeToString (JANUARY) ); 
106 assertEquals ("February", monthCodeToString (FEBRUARY) ) ; 
107 ‘assertEquals ("March", monthCodeToString (MARCH) ) ; 

108 assertEquals ("April", monthCodeToString (APRIL) ); 

109 assertEquals ("May", monthCodeToString (MAY) ) ; 

110 assertEquals ("June", monthCodeToString (JUNE) ) ; 

111 assertEquals ("July", monthCodeToString (JULY) ); 

112 assertEquals ("August", monthCodeToString (AUGUST) ) ; 

113 assertEquals ("September", monthCodeToString (SEPTEMBER) ) ; 
114 . assertEquals ("October", monthCodeToString (OCTOBER) ) ; 
115 assertEquals ("November", monthCodeToString (NOVEMBER) ) ; 
116 assertEquals ("December", monthCodeToString (DECEMBER)); 
117 

118 assertEquals("Jan", monthCodeToString (JANUARY, true)); 
119 assertEquals("Feb", monthCodeToString (FEBRUARY, true)); 
120 assertEquals("Mar", monthCodeToString (MARCH, true)); 
121 assertEquals("Apr", monthCodeToString(APRIL, true)); 
122 assertEquals ("May", monthCodeToString(MAY, true)); 

123 assertEquals("Jun", monthCodeToString(JUNE, true)); 

124 assertEquals("Jul", monthCodeToString(JULY, true)); 

125 assertEquals("Aug", monthCodeToString (AUGUST, true)); 
126 assertEquals("Sep", monthCodeToString (SEPTEMBER, true)); 
127 assertEquals ("Oct", monthCodeToString (OCTOBER, true)); 
128 assertEquals("Nov", monthCodeToString (NOVEMBER, true)); 
129 assertEquals("Dec", monthCodeToString (DECEMBER, true)); 
130 

131 try ( 

132 monthCodeToString(-1); 

133 fail("Invalid month code should throw exception"); 


134 ) catch (IllegalArgumentException e) ( 


135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 


) 
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public void testStringToMonthCode() throws Exception { 


assertEquals (JANUARY, stringToMonthCode ("1") ) ; 
assertEquals (FEBRUARY, stringToMonthCode ("2") ); 
assertEquals (MARCH, stringToMonthCode ("3") ); 
assertEquals (APRIL, stringToMonthCode ("4") ); 
assertEquals (MAY, stringToMonthCode ("5") ) ; 
assertEquals (JUNE, stringToMonthCode ("6") ) ; 
assertEquals (JULY, stringToMonthCode ("7") ); 
assertEquals (AUGUST, stringToMonthCode ("8") ) ; 
assertEquals (SEPTEMBER, stringToMonthCode ("9") ) ; 
assertEquals (OCTOBER, st ringToMonthCode ("10") ); 
assertEquals (NOVEMBER, stringToMonthCode("11")); 
assertEquals (DECEMBER, stringToMonthCode ("12") ); 


//todo assertEquals(-1, stringToMonthCode("0")); 


// 


assertEquals(-1, stringToMonthCode ("13") ); 
assertEquals (-1, stringToMonthCode ("Hello") ); 


for (int m = 1; m <= 12; m**) { 
assertEquals (m, stringToMonthCode (monthCodeToString(m, false) )); 
assertEquals (m, stringToMonthCode (monthCodeToString(m, true))); 
) 


assertEquals (1,stringToMonthCode ("jan")); 
assertEquals (2, stringToMonthCode ("feb")) ; 
assertEquals (3,stringToMonthCode ("mar")); 
assertEquals (4, stringToMonthCode ("apr")); 
assertEquals (5,stringToMonthCode ("may") ) ; 
assertEquals(6,stringToMonthCode ("jun")) ; 
assertEquals (7,stringToMonthCode ("jul")); 
assertEquals (8,stringToMonthCode ("aug") ); 
assertEquals (9, stringToMonthCode ("sep")) ; 
assertEquals (10, stringToMonthCode ("oct") ) ; 
assertEquals (11, stringToMonthCode ("nov") ) ; 
assertEquals (12, stringToMonthCode ("dec") ) ; 


assertEquals (1, stringToMonthCode ("JAN") ) ; 
assertEquals (2, stringToMonthCode ("FEB") ) ; 
assertEquals (3, stringToMonthCode ("MAR") ) ; 
assertEquals (4, stringToMonthCode ("APR") ) ; 
assertEquals (5, stringToMonthCode ("MAY") ) ; 
assertEquals (6, stringToMonthCode ("JUN")) ; 
assertEquals (7, stringToMonthCode ("JUL") ); 
assertEquals (8, stringToMonthCode ("AUG") ) ; 
assertEquals (9,stringToMonthCode ("SEP") ) ; 
assertEquals (10, stringToMonthCode ("OCT") ); 
assertEquals (11, stringToMonthCode ("NOV") ) ; 
assertEquals (12, stringToMonthCode ("DEC") ) ; 
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189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 


227. 


228 
229 
230 


231. 


232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 


// assertEquals (1,stringToMonthCode ("january")); 
// | assertEquals (2, stringToMonthCode ("february") ); 
// assertEquals (3, stringToMonthCode ("march") ) ; 

// assertEquals (4,stringToMonthCode ("april") ); 

// assertEquals (5,stringToMonthCode ("may") ) ; 

// assertEquals (6, stringToMonthCode ("june") ) ; 

// assertEquals (7,stringToMonthCode ("july") ); 

// assertEquals (8, stringToMonthCode ("august") ) ; 

// assertEquals (9, stringToMonthCode ("september")); 
// assertEquals (10, stringToMonthCode ("october") ) ; 
// assertEquals (11, stringToMonthCode ("november") ) ; 
// | assertEquals (12, stringToMonthCode ("december") ) ; 


// assertEquals (1, stringToMonthCode ("JANUARY") ) ; 
// assertEquals (2, stringToMonthCode ("FEBRUARY") ) ; 
// assertEquals (3, stringToMonthCode ("MAR") ) ; 

// assertEquals (4,stringToMonthCode ("APRIL") ) ; 

// assertEquals (5,stringToMonthCode ("MAY") ) ; 

// assertEquals (6, stringToMonthCode ("JUNE") ) ; 

// | assertEquals (7,stringToMonthCode ("JULY") ) ; 

// assertEquals (8, stringToMonthCode ("AUGUST")) ; 

// assertEquals (9, stringToMonthCode ("SEPTEMBER") ) ; 
// assertEquals (10, stringToMonthCode ("OCTOBER") ) ; 
// assertEquals (11, stringToMonthCode ("NOVEMBER") ) ; 
// assertEquals (12, stringToMonthCode ("DECEMBER") ) ; 


public void testIsValidWeekInMonthCode() throws Exception { 
for (int w = 0; w <= 4; wtt) { 
assertTrue (isValidWeekInMonthCode (w) ) ; 
} 
assertFalse(isValidWeekInMonthCode (5) ); 


} 


public void testIsLeapYear() throws Exception { 
assertFalse(isLeapYear (1900) ); 
assertFalse(isLeapYear (1901) ); 
assertFalse (isLeapYear (1902) ); 
assertFalse (isLeapYear (1903) ); 
assertTrue (isLeapYear (1904) ); 
assertTrue (isLeapYear (1908) ) ; 
assertFalse (isLeapYear (1955) ); 
assertTrue (isLeapYear (1964) ); 
assertTrue (isLeapYear (1980) ) ; 
assertTrue (isLeapYear (2000) ); 
assertFalse(isLeapYear (2001) ); 
assertFalse (isLeapYear (2100) ); 

) 


public void testLeapYearCount() throws Exception { 
assertEquals(0, leapYearCount(1900)); 
assertEquals(0, leapYearCount (1901)); 
assertEquals(0, leapYearCount(1902)); 
assertEquals(0, leapYearCount(1903)); 
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243 assertEquals(1, leapYearCount(1904)); 
244 assertEquals(1, leapYearCount (1905) ); 
245 assertEquals(1, leapYearCount (1906) ); 
246 assertEquals(1, leapYearCount(1907)); 
247 assertEquals(2, leapYearCount (1908) ); 
248 assertEquals(24, leapYearCount (1999) ); 
249 assertEquals(25, leapYearCount (2001) ); 
250 assertEquals (49, leapYearCount (2101) ); 
251 assertEquals(73, leapYearCount (2201) ); 
252 assertEquals(97, leapYearCount (2301) ); 
253 assertEquals(122, leapYearCount (2401) ); 
254 } | 
255 
256 ‘public void testLastDayOfMonth() throws Exception { 
257 assertEquals(31, lastDayOfMonth(JANUARY, 1901)); 
258 assertEquals (28, lastDayOfMonth(FEBRUARY, 1901)); 
259 assertEquals (31, lastDayOfMonth(MARCH, 1901)); 
260 assertEquals(30, lastDayOfMonth(APRIL, 1901)); 
261 assertEquals (31, lastDayOfMonth(MAY, 1901)); 
262 assertEquals(30, lastDayOfMonth(JUNE, 1901)); 
263 assertEquals(31, lastDayOfMonth(JULY, 1901)); 
264 assertEquals (31, lastDayOfMonth(AUGUST, 1901)); 
265 assertEquals (30, lastDayOfMonth(SEPTEMBER, 1901)); 
266 assertEquals(31, lastDayOfMonth(OCTOBER, 1901)); 
267 assertEquals (30, lastDayOfMonth(NOVEMBER, 1901)); 
268 assertEquals (31, lastDayOfMonth(DECEMBER, 1901)); 
269 assertEquals(29, lastDayOfMonth(FEBRUARY, 1904)); 
270 } 
211 
272 public void testAddDays() throws Exception { 
213 SerialDate newYears = d(1, JANUARY, 1900); 
214 assertEquals(d(2, JANUARY, 1900), addDays(1, newYears)); 
215 assertEquals(d(1, FEBRUARY, 1900), addDays(31, newYears)); 
216 assertEquals (d(1, JANUARY, 1901), addDays(365, newYears)); 
277 assertEquals(d(31, DECEMBER, 1904), addDays(5 * 365, newYears)); 
278 } 
279 
280 private static SpreadsheetDate d(int day, int month, int year) (return new 
SpreadsheetDate(day, month, year);) 
281 
282 public void testAddMonths() throws Exception { 
283 assertEquals (d(l, FEBRUARY, 1900), addMonths(1, d(1, JANUARY, 1900))); 
284 assertEquals(d(28, FEBRUARY, 1900), addMonths(1, d(31, JANUARY, 1900))); 
285 assertEquals(d(28, FEBRUARY, 1900), addMonths(1, d(30, JANUARY, 1900))); 
286 assertEquals (d(28, FEBRUARY, 1900), addMonths(1, d(29, JANUARY, 1900))); 
287 assertEquals (d(28, FEBRUARY, 1900), addMonths(1, d(28, JANUARY, 1900))); 
288 assertEquals (d(27, FEBRUARY, 1900), addMonths(1, d(27, JANUARY, 1900))); 
289 
290 assertEquals (d(30, JUNE, 1900), addMonths(5, d(31, JANUARY, 1900))); 
291 assertEquals (d(30, JUNE, 1901), addMonths(17, d(31, JANUARY, 1900))); 
292 
293 assertEquals (d(29, FEBRUARY, 1904), addMonths(49, d(31, JANUARY, 1900))); 
294 
295 } 
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296 
297 
298 
299 
300 
301 
302 
303 
304 
305 


306 
307 
308 


309 
310 
311 
312 
313 
314 
315 
316 
317 
318 


319 
320 
321 
322 
323 
324 
325 
326 
327 
328 
329 
330 
331 
332 
333 
334 
335 
336 


337 
338 


339 
340 
341 


public void testAddYears() throws Exception { 


assertEquals(d(1, JANUARY, 1901), addYears(1, d(1, JANUARY, 1900))); 
assertEquals(d(28, FEBRUARY, 1905), addYears(1, d(29, FEBRUARY, 1904))); 
assertEquals(d(28, FEBRUARY, 1905), addYears(1, d(28, FEBRUARY, 1904))); 


' assertEquals(d(28, FEBRUARY, 1904), addYears(1, d(28, FEBRUARY, 1903))); 


) 


public void testGetPreviousDayOfWeek() throws Exception ( 
assertEquals(d(24, FEBRUARY, 2006), getPreviousDayOfWeek (FRIDAY, 
d(1, MARCH, 2006))); 
assertEquals (d(22, FEBRUARY, 2006), getPreviousDayOfWeek (WEDNESDAY, 
.d(1, MARCH, 2006))); 
assertEquals (d(29, FEBRUARY, 2004), getPreviousDayOfWeek (SUNDAY, 
d(3, MARCH, 2004))); 
assertEquals(d(29, DECEMBER, 2004), getPreviousDayOfWeek (WEDNESDAY, 
d(5, JANUARY, 2005))); 


try { 
getPreviousDayOfWeek(-1, d(1, JANUARY, 2006)); 
fail("Invalid day of week code should throw exception"); 
} catch (IllegalArgumentException e) ( 
) 
) 


public void testGetFollowingDayOfWeek() throws Exception { 
/ / assertEquals (d(1, JANUARY, 2005),getFollowingDayOfWeek (SATURDAY, 
d(25, DECEMBER, 2004))); 
assertEquals(d(1, JANUARY, 2005), getFollowingDayOfWeek (SATURDAY, 
d(26, DECEMBER, 2004))); 
assertEquals(d(3, MARCH, 2004), ge thollon ngbayotWcek (WEDNESDAY, 
d(28, FEBRUARY, 2004))); 


try { 
getFollowingDayOfWeek(-1, d(1, JANUARY, 2006)); 
fail("Invalid day of week code should throw exception"); 
) catch (IllegalArgumentException e) ( 
) 
) 


public void testGetNearestDayOfWeek() throws Exception { 


assertEquals (d(16, APRIL, 2006), getNearestDayOfWeek (SUNDAY, d(16, APRIL, 
assertEquals (d(16, APRIL, 2006), getNearestDayOfWeek (SUNDAY, d (17, APRIL, 


assertEquals (d(16, APRIL, 2006), getNearestDayOfWeek (SUNDAY, d(18, APRIL, 
assertEquals (d(16, APRIL, 2006), getNearestDayOfWeek (SUNDAY, d(19, APRIL, 
assertEquals (d(23, APRIL, 2006), getNearestDayOfWeek (SUNDAY, d(20, APRIL, 
assertEquals (d(23, APRIL, 2006), getNearestDayOfWeek (SUNDAY, d(21, APRIL, 
assertEquals (d(23, APRIL, 2006), getNearestDayOfWeek (SUNDAY, d (22, APRIL, 


/ [todo assertEquals(d(17, APRIL, 2006), getNearestDayOfWeek (MONDAY, 
d(16, APRIL, 2006))); 
assertEquals (d(17, APRIL, 2006), getNearestDayOfWeek (MONDAY, d(17, APRIL, 
assertEquals (d(17, APRIL, 2006), getNearestDayOfWeek (MONDAY, d(18, APRIL, 
assertEquals (d(17, APRIL, 2006), getNearestDayOfWeek (MONDAY, d (19, APRIL, 


2006))); 
2006))); 
2006))); 
2006))); 
2006))); 
2006))); 
2006))); 


2006))); 
2006))); 
2006))); 


342 
343 
344 
345 
346 // 


347 // 
348 
349. 
350 
351 
352 
353 
354 // 
355 77 
356 // 
357 
358 
359 
360 


361 
362 // 


363-77 
364 // 
365 // 
366 
367 
368 


369 
370 // 
371// 
372// 
373 // 
314 // 
315 
376 
377 
378 // 
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assertEquals(d(17, APRIL, 2006), getNearestDayOfWeek (MONDAY, d(20, APRIL, 2006))); 
assertEquals (d(24, APRIL, 2006), getNearestDayOfWeek (MONDAY, d(21, APRIL, 2006) )); 
assertEquals(d(24, APRIL, 2006), getNearestDayOfWeek (MONDAY, d(22, APRIL, 2006) )); 


assertEquals (d(18, APRIL, 2006), getNearestDayOfWeek (TUESDAY, 

d(16, APRIL, 2006))); 

assertEquals(d(18, APRIL, 2006), 有 

d(17, APRIL, 2006))); 
assertEquals (d(18, APRIL, 2006) , getNearestDayOfWeek (TUESDAY, d (18, APRIL, 2006))); 
assertEquals (d(18, APRIL, 2006) , getNearestDayOfWeek (TUESDAY, d(19, APRIL, 2006))); 
assertEquals (d(18, APRIL, 2006), getNearestDayOfWeek (TUESDAY, d (20, APRIL, 2006))); 
assertEquals (d(18, APRIL, 2006) , getNearestDayOfWeek (TUESDAY, d (21, APRIL, 2006))); 
assertEquals (d(25, APRIL, 2006) , getNearestDayOfWeek (TUESDAY, d(22, APRIL, 2006))); 


assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek (WEDNESDAY 
d(16, APRIL, 2006))); 
assertEquals (d(19, APRIL, 2006), getNearestDayOfWeek (WEDNESDAY, 
d(17, APRIL, 2006))); 
.assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek (WEDNESDAY, 
d(18, APRIL, 2006))); 
assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek (WEDNESDAY, 
d(19, APRIL, 2006))); 
assertEquals (d(19, APRIL, 2006), getNearestDayOfWeek (WEDNESDAY, 
d(20, APRIL, 2006))); 
assertEquals (d(19, APRIL, 2006), getNearestDayOfWeek (WEDNESDAY, 
d(21, APRIL, 2006))); 
assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek (WEDNESDAY, 
d(22, APRIL, 2006))); 


assertEquals(d(13, APRIL, 2006), getNearestDayOfWeek (THURSDAY, 
d(16, APRIL, 2006))); 
assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek (THURSDAY, 
d(17, APRIL, 2006))); 
assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek (THURSDAY, 
d(18, APRIL, 2006))); 
assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek (THURSDAY, 
d(19, APRIL, 2006))); 
assertEquals (d(20, APRIL, 2006), getNearestDayOfWeek (THURSDAY, 
d(20, APRIL, 2006))); 
assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek (THURSDAY, 
d(21, APRIL, 2006))); 
assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek (THURSDAY, 
d(22, APRIL, 2006))); 


assertEquals (d (14, APRIL, 2006), getNearestDayOfWeek (FRIDAY, d(16, APRIL, 2006) )); 
assertEquals (d(14, APRIL, 2006) , getNearestDayOfWeek (FRIDAY, d(17, APRIL, 2006))); 
assertEquals (d (21, APRIL, 2006) , getNearestDayOfWeek (FRIDAY, d(18, APRIL, 2006) ) ); 
assertEquals (d(21, APRIL, 2006) , getNearestDayOfWeek (FRIDAY, d (19, APRIL, 2006))); 
assertEquals (d(21, APRIL, 2006) , getNearestDayOfWeek(FRIDAY, d(20, APRIL, 2006))); 
assertEquals (d(21, APRIL, 2006), getNearestDayOfWeek (FRIDAY, d(21, APRIL, 2006))); 
assertEquals (d(21, APRIL, 2006), getNearestDayOfWeek (FRIDAY, d(22, APRIL, 2006))); 


assertEquals(d(15, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(16, APRIL, 2006))); 
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379 
380 
381 
382 
383 
384 


385 
386 
387 
388 
389 
390 
391 
392 
393 
394 
395 
396 
397 
398 
399 
400 
401 
402 
403 


404 
405 
406 
407 
408 
409 
410 
411 
412 
413 
414 
415 
416 
417 
418 
419 
420 
421 
422 
423 
424 
425 


// 
// 
// 
// 
// 


} 


assertEquals(d(15, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(17, APRIL, 2006))); n 
assertEquals (d(15, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(18, APRIL, 2006))); | 
assertEquals(d(22, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(19, APRIL, 2006))); 
assertEquals (d(22, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(20, APRIL, 2006))); | 
assertEquals (d(22, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(21, APRIL, 2006))); 
assertEquals(d(22, APRIL, 2006), getNearestDayOfWeek (SATURDAY, 
d(22, APRIL, 2006))); | 


try ( 

getNearestDayOfWeek(-1, d(1, JANUARY, 2006)); 

fail("Invalid day of week code should throw exception"); ' 
} catch (IllegalArgumentException e) { 
} 


public void testEndOfCurrentMonth() throws Exception { 


) 


SerialDate d = SerialDate.createInstance (2); 

assertEquals(d(31, JANUARY, 2006), d.getEndOfCurrentMonth(d(1l, JANUARY, 2006))); 
assertEquals (d(28, FEBRUARY, 2006), d.getEndOfCurrentMonth (d(1, FEBRUARY, 2006))) ; 
assertEquals(d(31, MARCH, 2006), d.getEndOfCurrentMonth(d(1, MARCH, 2006))); 
assertEquals(d(30, APRIL, 2006), d.getEndOfCurrentMonth(d(1, APRIL, 2006))); 
assertEquals(d(31, MAY, 2006), d.getEndOfCurrentMonth(d(1, MAY, 2006))); 
assertEquals(d(30, JUNE, 2006), d.getEndOfCurrentMonth(d(1, JUNE, 2006))); 
assertEquals(d(31, JULY, 2006), d.getEndOfCurrentMonth(d(1, JULY, 2006))); 
assertEquals(d(31, AUGUST, 2006), d.getEndOfCurrentMonth(d(1, AUGUST, 2006))); 
assertEquals(d(30, SEPTEMBER, 2006), d.getEndOfCurrentMonth | 

(d(1, SEPTEMBER, 2006))); 

assertEquals (d(31, OCTOBER, 2006), d.getEndOfCurrentMonth (d(1, OCTOBER, 2006))); 
assertEquals (d(30, NOVEMBER, 2006), d.getEndOfCurrentMonth (d(1, NOVEMBER, 2006))); 
assertEquals (d(31, DECEMBER, 2006), d.getEndOfCurrentMonth (d(1, DECEMBER, 2006) )); 
assertEquals (d(29, FEBRUARY, 2008), d.getEndOfCurrentMonth (d(1, FEBRUARY, 2008))); 


public void testWeekInMonthToString() throws Exception { 


assertEquals ("First",weekInMonthToString (FIRST WEEK IN MONTH) ) ; 
assertEquals ("Second",weekInMonthToString (SECOND WEEK IN MONTH) ) ; 
assertEquals ("Third", weekInMonthToString (THIRD_WEEK_IN_MONTH) ) ; 
assertEquals ("Fourth",weekInMonthToString (FOURTH_WEEK_IN_MONTH) ) ; 
assertEquals ("Last",weekInMonthToString (LAST_WEEK_IN_MONTH) ) ; 


//todo try { 


// 
// 
// 


// 
) 


weekInMonthToString(-1); 

fail("Invalid week code should throw exception"); 
) catch (IllegalArgumentException e) { 
) 


public void testRelativeToString() throws Exception { 


assertEquals ("Preceding",relativeToString (PRECEDING) ) ; 


附录 B org.jfree.date.SerialDate 363 


426 assertEquals ("Nearest",relativeToString (NEAREST) ) ; 
427 assertEquals ("Following", relativeToString (FOLLOWING) ) ; 


428 

429 //todo try { 

430 // relativeToString (-1000) ; 

431 // ‘fail("Invalid relative code should throw exception"); 
432 // } catch (IllegalArgumentException e) { 

433 // } 

434 } 

435 


436 public void testCreateInstanceFromDDMMYYY() throws Exception { 
437 SerialDate date = createInstance(1, JANUARY, 1900); 
438 assertEquals (1,date.getDayOfMonth()); 
439 assertEquals (JANUARY, date .getMonth () ) ; 
440 assertEquals (1900,date.getYYYY () ) ; 
441 assertEquals (2,date.toSerial()); 
442  ) 
443 
444 public void testCreateInstanceFromSerial() throws Exception { 
445 assertEquals (d(1, JANUARY, 1900),createInstance(2)); 
446 assertEquals (d(l1, JANUARY, 1901), createInstance(367)); 
447  ) | 
448 
449 public void testCreateInstanceFromJavaDate() throws Ge { 
450 assertEquals (d(1, JANUARY, 1900), 
createInstance (new ee 
451 assertEquals(d(1, JANUARY, 2006), 
createInstance (new GregorianCalendar (2006,0,1).getTime())); 


452 } 

453 

454 public static void main(String[] args) { 

455 junit.textui.TestRunner.run(BobsSerialDateTest.class); 
456 } 

457 } 


代码 清单 B-5 SpreadsheetDate.java 


License for more details. 


4 * 

5 * (C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 

6 * 

7 * Project Info: http://www.jfree.org/jcommon/index.html 

8 * 

9 * This library is free software; you can redistribute it and/or modify it 
10 * under the terms of the GNU Lesser General Public License as published by 
11 * the Free Software Foundation; either version 2.1 of the License, or 
12 * (at your option) any later version. 

Lge 3f 
14 * This library is distributed in the hope that it will be useful, but 
15 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
16 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 
* 
* 
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+ + + + +*+ X 


* + * 


+ + + X* X X 


+ SS 


SS 


You should have received a copy of the GNU Lesser General Public 

License along with this library; if not, write to the Free Software 
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 
USA. 


[Java is a trademark or registered trademark of Sun Microsystems, Inc. 


in the United States and other countries. ] 


(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 


Original Author: David Gilbert (for Object Refinery Limited); 
Contributor(s): ~; i 


4 


$Id: SpreadsheetDate.java,v 1.8 2005/11/03 09:25:39 mungady Exp $ 


Changes 

11-Oct-2001 : Version 1 (DG); 

05-Nov-2001 : Added getDescription() and setDescription() methods (DG); 

12-Nov-2001 : Changed name from ExcelDate.java to SpreadsheetDate.java (DG); 
Fixed a bug in calculating day, month and year from serial 
number (DG); 

24-Jan-2002 : Fixed a bug in calculating the serial number from the day, 
month and year. Thanks to Trevor Hills for the report (DG); 

29-May-2002 : Added equals(Object) method (SourceForge ID 558850) (DG); 

03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

13-Mar-2003 : Implemented Serializable (DG); 

04-Sep-2003 : Completed isInRange() methods (DG); 

05-Sep-2003 : Implemented Comparable (DG); 

21-Oct-2003 : Added hashCode() method (DG); 


package org.jfree.date; 


import java.util.Calendar; 
import java.util.Date; 


/** 

* Represents a date using an integer, in a similar fashion to the 

* implementation in Microsoft Excel. The range of dates supported is 

* 1-Jan-1900 to 31-Dec-9999. 

* «p» 

* Be aware that there is a deliberate bug in Excel that recognises the year 
* 1900 as a leap year when in fact it is not a leap year. You can find more 
* information on the Microsoft website in article 0181370: 

* <P> 

* http://support.microsoft.com/support/kb/articles/Q181/3/70.asp 

* <P> 

* Excel uses the convention that l-Jan-1900 = 1. This class uses the 

* convention 1-Jan-1900 = 2. 
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73 * The result is that the day number in this class will be different to the 

74 * Excel figure for January and February 1900...but then Excel adds in an extra 
75 * day (29-Feb-1900 which does not actually exist!) and from that point forward 
76 * the day numbers will match. 

7 7 * 

78 * @author David Gilbert 

79 */ 

80 public class SpreadsheetDate extends SerialDate { 

81 

82 /** For serialization. */ 


83 private static final long serialVersionUID = -2039586705374454461L; 
84 


85 /** i 

86 * The day number (1-Jan-1900 = 2, 2-Jan-1900 = 3, ..., 31-Dec-9999 = 
87 * 2958465). 

88 WI 

89 private int serial; 

90 


91 /** The day of the month (1 to 28, 29, 30 or 31 depending on the month). */ 
92 private int day; 


93 

94 /** The month of the year (1 to 12). */ 

95 private int month; 

96 

97 /** The year (1900 to 9999). */ 

98 private int year; 

99 

100 /** An optional description for the date. */ 

101 private String description; 

102 

103 [** 

104 * Creates a new date instance. 

105 - * 

106 * (param day the day (in the range 1 to 28/29/30/31). 
107 * (param month the month (in the range 1 to 12). 
108 * (iparam year the year (in the range 1900 to 9999). 
109 +) 


110 public 8preadsheetDate(final int day, final int month, final int year) { 
111 


112 if ((year >= 1900) && (year <= 9999)) { 

113 this.year = year; 

114 } 

115 else { 

116 throw new IllegalArgumentException ( 

117 "The 'year' argument must be in range 1900 to 9999." 
118 ); M 

119 ) 

120 

121 if ((month >= MonthConstants.JANUARY) 

122 && (month <= MonthConstants.DECEMBER)) { 
123 this.month = month; 

124 ) 

125 else ( 


126 throw new IllegalArgumentException( 
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127 "The 'month' argument must be in the range 1 to 12." 

128 ES 

129 ) 

130 

131 if ((day >= 1) && (day <= SerialDate.lastDayOfMonth (month, year))) { 
132 this.day = day; | 

133 ) 
| 134 else { 

135 throw new IllegalArgumentException("Invalid 'day' argument."); 
136 ) x | 

137 

138 // the serial number needs to be synchronised with the day-month-year... 
139 this.serial - calcSerial(day, month, year); 

140 

141 this.description = null; 

142 ; 

143 ) 

144 

145 ]** 

146 * Standard constructor - creates a new date object representing the 
147 * specified day number (which should be in the range 2 to 2958465. 
148 * 

149 * (iparam serial the serial number for the day (range: 2 to 2958465). 
150 */ 

151 public SpreadsheetDate (final int serial) { 

152 

153 if ((serial >= SERIAL_LOWER_BOUND) && (serial <= SERIAL UPPER BOUND)) { 
154 this.serial = serial; 

155 } 

156 else { 

157 throw new IllegalArgumentException( 

158 "SpreadsheetDate: Serial must be in range 2 to 2958465."); 
159 ) 

160 

161 // the day-month-year needs to be synchronised with the serial number... 
162 calcDayMonthYear(); 

163 

164 ) 

165 

166 /** 

167 * Returns the description that is attached to the date. It is not 

168 * required that a date have a description, but for some applications it 
169 * is useful. 

170 * 

171 * @return The description that is attached to the date. 

172 Wi 

173 public String getDescription() { 

174 return this.description; 

175 ) 

176 

177 /** 

178 * Sets the description for the date. 

179 * 

180 * (iparam description the description for this date (<code>null</code> 
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181 * permitted). 

182 ud 

183 public void setDescription(final String description) ( 

184 this.description = description; 

185 ) 

186 

187 [ax | 

188 * Returns the serial number for the date, where 1 January 1900 - 2 
189 * (this corresponds, almost, to the numbering system used in Microsoft 
190 * Excel for Windows and Lotus 1-2-3). 

191 x 

192 * @return The serial number of this date. 

193 */ | 

194 public int toSerial() ( 

195 return this.serial; 

196 } 

197 

198 Lë 

199 . * Returns a <code>java.util.Date</code> equivalent to this date. 
200 * 7 | , 

201 * (return The date. 

202 Gë 

203 public Date toDate() 1{ 

204 final Calendar calendar = Calendar.getInstance(); 

205 calendar.set(getYYYY(), getMonth() - 1, getDayOfMonth(), 0, 0, 0); 
206 return calendar.getTime(); 

207 } 

208 

209 /** 

210 * Returns the year (assume a valid range of 1900 to 9999). 
211 * 

212 * @return The year. 

213 af 

214 public int getYYYY() ( 

215 return this.year; 

216 ) 

217 

218 [** d 

219 * Returns the month (January = 1, February = 2, March = 3). 
220 * 

221 * (return The month of the yéàf; 

222 * 

223 public int getMonth() í( 

224 return this.month; 

225 ) 

226 

227 /** 

228 * Returns the day of the month. 

230 * (ireturn The day of the month. 

231 Së 

232 public int getDayOfMonth() ( 

233 return this.day; 


234 } 
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235 

236 /** 

237 * Returns a code representing the day of the week. 

238 * <P> 

239 yw The codes are defined in the {@link SerialDate} class as: 

240 .* <code>SUNDAY</code>, <code>MONDAY</code>, <code>TUESDAY</code>, 
241 * <code>WEDNESDAY</code>, <code>THURSDAY</code>, <code>FRIDAY</code>, and 
242 * «code»SATURDAY«/code».: | dé 

243 E 5 | 

244 * @return A code representing the day of the week. 

245 */ 

246 public int getDayOfWeek() ( 

247 return (this.serial + 6) $ 7 * 1; 

248 ) 

249 

250 CS? / 

251 * Tests the equality of this date with an arbitrary object. 

252 * «p» 

253 * This method will return true ONLY if the object is an instance of the 
254 * {@link SerialDate} base class, and it represents the same day as this 
255 * {@link SpreadsheetDate}. 

256 g 

257 * @param object the object to compare (<code>null</code> permitted). 
258 $ 

259 . * @return A boolean. 

260 SÉ 

261 public boolean equals(final Object object) í( 

262 

263 if (object instanceof SerialDate) { 

264 final SerialDate s = (SerialDate) object; 

265 return (s.toSerial() == this.toSerial()); 

266 } 

267 else { 

268 return false; 

269 } 

270 

271 } 

272 

273 /[** 

274 * Returns a hash code for this object instance. 

275 * 

216 * @return A hash code. 

211 */ 

278 public int hashCode() { 

219 return toSerial(); 

280 } 

281 

282 /** ! 

283 * Returns the difference (in days) between this date and the specified 
284 * 'other' date. 

285 7 

286 * @param other the date being compared to. 

287 * 

288 * @return The difference (in days) between this date and the specified 


289 
290 
291 
292 
293 
294 
295 
296 
297] 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 
314 
315 
316 
317 
318 
319 
320 
321 
322 
323 
324 
325 
326 
327 
328 
329 
330 
331 
332 
333 
334 
335 
336 
337 
338 
339 
340 
341 
342 


附录 B org.jfree.date.SerialDate 369 


* 'other' date. 

*/ 

public int compare(final SerialDate other) ( 
return this.serial - other.toSerial(); 


) 


/** 
* Implements the method required by the Comparable interface. 
* 


* @param other the other object (usually another SerialDate). 
* 
* (return A negative integer, zero, or a positive integer as this object 
A is less than, equal to, or greater than the specified object. 
"7 
public int compareTo (final Object other) { 
return compare ( (SerialDate) other); 
} . 


* Returns true if this SerialDate represents .the same date as the 
* specified SerialDate. 
* 


* @param other the date being compared to. 
* 


* (return <code>true</code> if this SerialDate represents the same date as 


* the specified SerialDate. 

*/ 

public boolean isOn (final SerialDate other) { 
return (this.serial == other.toSerial()); 

) 

/** 


* Returns true if this SerialDate represents an earlier date compared to 
* the specified SerialDate. 
* 


* (param other the date being compared to. 
* s 
* @return <code>true</code> if this SerialDate represents an earlier date 
x compared to the specified SerialDate. 
*/ 
public boolean isBefore (final SerialDate other) { 
return (this.serial < other.toSerial()); 


) 


/** 

* Returns true if this SerialDate represents the same date as the 
* specified SerialDate. 

* 


* (iparam other the date being compared to. 

* 

* @return <code>true</code> if this SerialDate represents the same date 
* as the specified SerialDate. 

*/ 

public boolean isOnOrBefore(final SerialDate other) ( 
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343 return (this.serial <= other.toSerial()); 

344 ) 

345 

346 [** 

347 * Returns true if this SerialDdte represents the same date as the 

348 * specified SerialDate. 

349 * 

350 * (param other the date being compared to. 

351 * 

352 * @return <code>true</code> if this SerialDate represents the same date 
353 * as the specified SerialDate. 

354 e 

355 public boolean isAfter(final SerialDate other) { 

356 return (this.serial > other.toSerial()); 

357 ) 

358 , 

359 (a 

360 * Returns true if this SerialDate represents the same date as the 

361 * specified SerialDate. 

362 * 

363 * @param other the date being compared to. 

364 * 

365 * (return <code>true</code> if this SerialDate represents the same date as 
366 * the specified SerialDate. 

367 Eé 

368 public boolean isOnOrAfter(final SerialDate other) { 

369 return (this.serial >= other.toSerial()); 

370 ) 

371 

372 /** 

373 * Returns <code>true</code> if this {@link SerialDate} is within the 
374 * specified range (INCLUSIVE). The date order of dl and d2 is not 

375 * important. 

376 * 

377 * @param dl a boundary date for the range. 

378 * (iparam d2 the other boundary date for the range. 

379 * 

380 © * @return A boolean. 

381 St 

382 public boolean isInRange(final SerialDate dl, final SerialDate d2) { 
383 return isInRange(dl, d2, SerialDate.INCLUDE BOTH); 

384 } 

385 

386 [et 

387 * Returns true if this SerialDate is within the specified range (caller 
388 * specifies whether or not the end-points are included). The order of dl 
389 * and d2 is not important. 

390 S 

391 * @param dl one boundary date for the range. 

392 * (param d2 a second boundary date for the range. 

393 * (param include a code that controls whether or not the start and end 
394 * dates are included in the range. 

395 * 

396 * (return <code>true</code> if this SerialDate is within the specified 
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*/ 
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range. 


un boolean isInRange(final SerialDate dl, final SerialDate d2, 


M 
不 
+ 


+ E < >+ 


NS 


final int s2 


final int include) { 
dl.toSerial(); 
d2.toSerial(); 
final int start - Math.min(sl, s2); 
final int end = Math.max(sl, s2); 


final int sl 


final int s = toSerial(); 

if (include == SerialDate.INCLUDE BOTH) { 
return (s >= start && s <= end); 

) 

else if (include == SerialDate.INCLUDE FIRST) { 
return (s >= start && s < end); 

) 

else if (include == SerialDate.INCLUDE SECOND) ( 
return (s > start && s <= end); 

) 

else ( 
return (s > start && s < end); 


Calculate the serial number from the day, month and year. 
«P» 
1-Jan-1900 = 2. 


(param d the day. 
@param m the month. 


@param y the year. 


@return the serial number from the day, month and year. 


private int calcSerial(final int d, final int m, final int y) ( 


) 


/** 


* 


*/ 


final int yy = ((y - 1900) * 365) + SerialDate.leapYearCount(y - 1); 
int mm = SerialDate.AGGREGATE DAYS TO END OF PRECEDING MONTH [m]; 
if (m » MonthConstants.FEBRUARY) ( 

if (SerialDate.isLeapYear(y)) { 

mm - mm * 1; 

) 
) 
final int dd = d; 
return yy + mm + dd + 1; 


Calculate the day, month and year from the serial number. 


private void calcDayMonthYear() { 


// get the year from the serial date 
final int days = this.serial - SERIAL_LOWER_BOUND; 
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451 // overestimated because we ignored leap days 

452 final int overestimatedYYYY = 1900 + (days / 365); 
453 final int leaps = SerialDate.leapYearCount (overestimatedYYYY); 
454 final int nonleapdays - days - leaps; 

455 // underestimated because we overestimated years 

456 int underestimatedYYYY = 1900. + (nonleapdays / 365); 
457 

458 if (underestimatedYYYY -- overestimatedYYYY) ( 

459 this.year - underestimatedYYYY; 

460 ) | 

461 else ( 

462 int ssl - calcSerial(1, 1, underestimatedYYYY); 
463 while (ssl <= this.serial) ( 

464 underestimatedYYYY = underestimatedYYYY + 1; 
465 ssl = calcSerial(1l, 1, underestimatedYYYY); 
466 } ! 
467 this.year = underestimatedYYYY - 1; 

468 } 

469 

470 final int ss2 = calcSerial(1, 1, this.year) ; 

471 

472 int[] daysToEndOfPrecedingMonth 

473 = AGGREGATE DAYS TO END OF PRECEDING MONTH; 

474 

475 if (isLeapYear(this.year)) { 

476 daysToEndOfPrecedingMonth 

4T] = LEAP YEAR AGGREGATE DAYS TO END OF PRECEDING MONTH; 
478 ) 

479 

480 // get the month from the serial date 

481 int mm = 1; 

482 int sss = ss2 + daysToEndOfPrecedingMonth[mm] - 1; 
483 while (sss < this.serial) { 

484 mm = mm * 1; 

485 sss = ss2 + daysToEndOfPrecedingMonth[mm] - 1; 
486 ] 

487 this.month = mm - 1; 

488 | 

489 // what's left is d(*1); 

490 this.day = this.serial - ss2 

491 - daysToEndOfPrecedingMonth[this.month] * 1; 
492 | 

493 ) 

494 

495 } 
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* JCommon : a free general purpose class library for the Java(tm) platform 


(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 


NO AUN 
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This library is free software; you can redistribute it and/or modify it 
under the terms of the GNU Lesser General Public License as published by 
the Free Software Foundation; either version 2.1 of the License, or 

(at your option) any later version. 


This library is distributed in the hope that it will be useful, but 
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 
License for more details. 


You should have received a copy of the GNU Lesser General Public 

License along with this library; if not, write to the Free Software 
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 
USA. 


[Java is a trademark or registered trademark of Sun Microsystems, Inc. 
in the United States and other countries.] 


(C) Copyright 2000-2003, by Object Refinery Limited and Contributors. 


Original Author: David Gilbert (for Object Refinery Limited); 
Contributor(s): -; A 


$Id: RelativeDayOfWeekRule.java,v 1.6 2005/11/16 15:58:40 taqua Exp $ 
Changes (from 26-Oct-2001) 


26-Oct-2001 : Changed package to com.jrefinery.date.*; 


* 03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

" 

t 

package org.jfree.date; 

has | 

* An annual date rule that returns a date for each year based on (a) a 
* reference rule; (b) a day of the week; and (c) a selection parameter 
* (SerialDate.PRECEDING, SerialDate.NEAREST, SerialDate.FOLLOWING). 

* <P> 

* For example, Good Friday can be specified as 'the Friday PRECEDING Easter 
* Sunday'. | 

* 

* @author David Gilbert 

*/ 

public class RelativeDayOfWeekRule extends AnnualDateRule { 


/** A reference to the annual date rule on which this rule is based. */ 
private AnnualDateRule subrule; 
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/** 
* The day of the week (SerialDate.MONDAY, SerialDate.TUESDAY, and so on). 
*/ 

private int dayOfWeek; 


/** Specifies which day of the week (PRECEDING, NEAREST or FOLLOWING). */ 
private int relative; | 


i | 
* Default constructor - builds a rule for the Monday following 1 January. 
*/ | 
public RelativeDayOfWeekRule() { 
this (new DayAndMonthRule(), SerialDate.MONDAY, SerialDate.FOLLOWING); 
) 


/ ** n 


Standard constructor - builds rule based on the supplied sub-rule. 


* 
* 
* @param subrule the rule that determines the reference date. 
* (param dayOfWeek the day-of-the-week relative to the reference date. 
* (param relative indicates *which* day-of-the-week (preceding, nearest 
* or following). 
public RelativeDayOfWeekRule(final AnnualDateRule subrule, 
final int dayOfWeek, final int relative) { 
this.subrule = subrule; 
this.dayOfWeek = dayOfWeek; 
this.relative - relative; 
) 


/** 
* Returns the sub-rule (also called the reference rule). 
* ; 
* (return The annual date rule that determines the reference date for this 
* rule. 
xf 
public AnnualDateRule getSubrule() { 
return this.subrule; 


) 
HI 


* Sets the sub-rule. 
* 
* (param subrule the annual date rule that determines the reference date 
* for this rule. 
wi 
public void setSubrule(final AnnualDateRule subrule) ( 
this.subrule = subrule; 


} 
/** 


* Returns the day-of-the-week for this rule. 
" | 


* (return the day-of-the-week for this rule. 
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115 
116 public int getDayOfWeek() { 
117 return this,dayOfWeek; 
118 ) 
119 
120 [XS | 
121 * Sets the day-of-the-week for this rule. 
122 S 
123 * (param dayOfWeek the day-of-the-week (SerialDate.MONDAY, 
124 * SerialDate.TUESDAY, and so on). 
125 */ è 
126 public void setDayOfWeek(final int dayOfWeek) { 
127 this.dayOfWeek = dayOfWeek; 
128 ) 
129 
. 130 [A 
131 * Returns the 'relative' attribute, that determines *which* 
132 * day-of-the-week we are interested in (SerialDate.PRECEDING, 
133 * SerialDate.NEAREST or SerialDate.FOLLOWING). 
134 | 
135 * @return The 'relative' attribute. 
136 */ 
137 public int getRelative() ( 
138 return this.relative; 
139 } 
140 
141 [** 
142 * Sets the 'relative' attribute (SerialDate.PRECEDING, SerialDate.NEAREST, 
143 * SerialDate.FOLLOWING). 
144 * 
145 * @param relative determines *which* day-of-the-week is selected by this 
146 * rule. 
147 */ 
148 public void setRelative(final int relative) ( 
149 this.relative - relative; 
150 } 
151 
152 [ts : 
153 * Creates a clone of this rule. 
154 * 
155 * @return a clone of this rule. 
156 * | 
157 * (throws CloneNotSupportedException this should never happen. 
158 sy 
159 public Object clone() throws CloneNotSupportedException { 
160 final RelativeDayOfWeekRule duplicate 
161 - (RelativeDayOfWeekRule) super.clone(); 
162 duplicate.subrule = (AnnualDateRule) duplicate.getSubrule().clone(); 
163 return duplicate; 
164 } | 
165 
166 pr 
167 * Returns the date generated by this rule, for the specified year. 


168 * 
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169 * (param year the year (1900 &lt;= year &lt;- 9999). 

170 * | 

171 * @return The date generated by the rule for the given year (possibly 
172 * <code>null</code>) . 

173 Sé 

174 public SerialDate getDate(final int year) { 

175 

176 // check argument... 

177 if ((year < SerialDate.MINIMUM YEAR SUPPORTED) 

178 || (year > SerialDate.MAXIMUM YEAR SUPPORTED)) { 

179 . throw new IllegalArgumentException ( 

180 "RelativeDayOfWeekRule.getDate(): year outside valid range."); 
181 } 

182 

183 // calculate the date... 

184 SerialDate result = null; 

185 final SerialDate base = this.subrule.getDate (year); 

186 : 

187 if (base != null) { 

188 switch (this.relative) ( 

. 189 case (SerialDate.PRECEDING): 

190 result = SerialDate.getPreviousDayOfWeek (this.dayOfWeek, 
191 base); 

192 break; 

193 ^. case(SerialDate.NEAREST): 

194 result = SerialDate.getNearestDayOfWeek(this.dayOfWeek, 
195 base); 

196 break; 

197 case (SerialDate.FOLLOWING): 

198 result = SerialDate.getFollowingDayOfWeek(this.dayOfWeek, 
199 base); 

200 break; 

201 default: 

202 break; 

203 ) 

204 } 

205 return result; 

206 

207 ) 

208 

209 ) 


代码 清单 B-7 DayDatejava 〈 最 终 版 本 ) 
1 /* SEET EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EES 


4 * 

5 * (C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 
36 */ 

37 package org.jfree.date; 


38 
39 import java.io.Serializable; 
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40 import java.util.*; 


41. 


42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
71 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 


二 + + HF sz HW HF FH HF HF zz AY 


/** 


An abstract class that represents immutable dates with a precision of 
one day. The implementation will map each date to an integer that 
represents an ordinal number of days from some fixed origin. 


Why not just use java.util.Date? We will, when it makes sense, At times, 
java.util.Date can be *too* precise - it represents an instant in time, 
accurate to 1/1000th of a second (with the date itself depending on the 
time-zone). Sometimes we just want to represent a particular day (e.g. 21 
January 2015) without concerning ourselves about the time of day, or the 
time-zone, or anything else. That's what we've defined DayDate for. 


Use DayDateFactory.makeDate to create an instance. 


@author David Gilbert 
@author Robert C. Martin did a lot of refactoring. 


+ 
D x 


public abstract class DayDate implements Comparable, Serializable { 


public abstract int getOrdinalDay(); 
public abstract int getYear(); 
public abstract Month getMonth(); 
public abstract int getDayOfMonth(); 


protected abstract Day getDayOfWeekForOrdinalZero(); 


public DayDate plusDays(int days) { 
return DayDateFactory.makeDate(getOrdinalDay() + days); 
) 


public DayDate plusMonths(int months) { 
int thisMonthAsOrdinal = getMonth().toInt() - Month.JANUARY.toInt(); 
int thisMonthAndYearAsOrdinal = 12 * getYear() + thisMonthAsOrdinal; 
int resultMonthAndYearAsOrdinal = thisMonthAndYearAsOrdinal + months; 
int resultYear = resultMonthAndYearAsOrdinal / 12; 
int resultMonthAsOrdinal = resultMonthAndYearAsOrdinal $ 12 * Month.JANUARY.toInt(); 
Month resultMonth = Month.fromInt(resultMonthAsOrdinal); 
int resultDay = correctLastDayOfMonth(getDayOfMonth(), resultMonth, resultYear); 
return DayDateFactory.makeDate(resultDay, resultMonth, resultYear); 


) 


public DayDate plusYears(int years) ( 
int resultYear = getYear() + years; 
int resultDay = correctLastDayOfMonth(getDayOfMonth(), getMonth(), resultYear); 
return DayDateFactory.makeDate (resultDay, getMonth(), resultYear); 

) 


private int correctLastDayOfMonth(int day, Month month, int year) ( 
int lastDayOfMonth = DateUtil.lastDayOfMonth (month, year); 
if (day > lastDayOfMonth) 
day » lastDayOfMonth; 
return day; 
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94 } 

95 

96 public DayDate getPreviousDayOfWeek(Day targetDayOfWeek) { 

97 int offsetToTarget = targetDayOfWeek.toInt() - getDayOfWeek().toInt(); 
98 if (offsetToTarget >= 0) 8 


99 offsetToTarget -= 7; 

100 return plusDays (offsetToTarget); 
101 } | 2 | 

102 


103 public DayDate getFollowingDayOfWeek(Day targetDayOfWeek) ( 
104 int offsetToTarget = targetDayOfWeek.toInt() - getDayOfWeek().toInt(); 
105 if (offsetToTarget <= 0) 


106 offsetToTarget += 7; mE 

107 return plusDays (offsetToTarget); 

108 } 

109 | / 


110 public DayDate getNearestDayOfWeek(Day targetDayOfWeek) { 

111 int offsetToThisWeeksTarget = targetDayOfWeek.toInt() -~ getDayOfWeek().toInt(); 
112 int offsetToFutureTarget = (offsetToThisWeeksTarget + 7) $ 7; 

113 int offsetToPreviousTarget - offsetToFutureTarget - 7; 


114 

115 if (offsetToFutureTarget > 3) 

116 return plusDays (offsetToPreviousTarget) ; 
117 else 

118 return plusDays (offsetToFutureTarget) ; 
119 } 

120 


121 public DayDate getEndOfMonth() { 

122 Month month = getMonth(); 

123 int year = getYear(); 

124 int lastDay = DateUtil.lastDayOfMonth(month, year); 


125 return DayDateFactory.makeDate(lastDay, month, year); 
126 } 

127 

128 public Date toDate() { 

129 final Calendar calendar = Calendar.getInstance(); 


130 int ordinalMonth = getMonth().toInt() ~ Month.JANUARY.toInt(); 
131 calendar.set(getYear(), ordinalMonth, getDayOfMonth(), 0, 0, 0); 
132 return calendar.getTime(); 

]33- 34 

134 

135 public String toString() { | 

136 return String.format("$02d-$s-$d", getDayOfMonth(), getMonth(), getYear()); 
137 | ) i 

138 

139 public Day getDayOfWeek() ( 

140 Day startingDay = getDayOfWeekForOrdinalZero(); 

141 int startingOffset = startingDay.toInt() - Day.SUNDAY.toInt(); 
142 int ordinalOfDayOfWeek = (getOrdinalDay() + startingOffset) $ 7; 
143 return Day.fromInt(ordinalOfDayOfWeek + Day.SUNDAY.toInt()); 

144 } 

145 

146 public int daysSince(DayDate date) { 

147 return getOrdinalDay() - date.getOrdinalDay(); 
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148 } 

149 

150 public boolean isOn(DayDate other) { 

151 return getOrdinalDay() == other.getOrdinalDay(); 
152 } 

153 


154 public boolean isBefore(DayDate other) ( 

155 return getOrdinalDay() « other.getOrdinalDay(); 

156 } 

157 

158 public boolean isOnOrBefore (DayDate other) { 

159 return getOrdinalDay() <= other.getOrdinalDay(); 

160 ) 

161 

162 public boolean isAfter(DayDate other) { 

163 return getOrdinalDay() > other.getOrdinalDay(); 

164 } 

165 

166 public boolean isOnOrAfter(DayDate other) { 

167 return getOrdinalDay() >= other.getOrdinalDay(); 

168 } 

169 

170 public boolean isInRange(DayDate dl, DayDate d2) { 

171 return isInRange(dl, d2, DateInterval.CLOSED); 

172 } 

` 173 

174 public boolean isInRange(DayDate dl, DayDate d2, DateInterval interval) { 
175 int left = Math.min(dl.getOrdinalDay(), d2.getOrdinalDay()); 
176 int right = Math.max(dl.getOrdinalDay(), d2.getOrdinalDay()); 
177 return interval.isIn(getOrdinalDay(), left, right); 

178 } 

179 } 


代码 清单 B-8 Monthjava 〈 最 终 版 本 ) 
1 package org.jfree.date; 


ho 


H 


import java.text.DateFormatSymbols; 


JANUARY(1), FEBRUARY(2), MARCH(3), 
APRIL(4),  MAY(5), JUNE (6), 
JULY (7), AUGUST (8), SEPTEMBER (9) ， 
9  OCTOBER(10), NOVEMBER (11) , DECEMBER (12) ; 
10 private static DateFormatSymbols dateFormatSymbols = new DateFormatSymbols(); 
1l private static final int[] LAST DAY OF MONTH - 
12 (0, 31; 28, 31, 30, 31, 30, 31, 31, 30, 31, .30, 31); 


3 
4 
5 public enum Month { 
6 
] 
8 


13 

14 private int index; 
15 | 

l6 Month(int index) ( 
17 this.index = index; 
18} 
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20 public static Month fromInt(int monthIndex) ( 
21 for (Month m : Month.values()) ( 


22 if (m.index -- monthIndex) 

23 return m; 

24 ) 

25 throw new IllegalArgumentException ("Invalid month index " + monthIndex); 
26 } 

27 


28 public int lastDay() { 

29 return LAST DAY OF MONTH[index]; 

30 } 

31 

32 public int quarter() { 

33 return 1 * (index - 1) / 3; 

34 } 

35 

36 public String toString() ( 

37 return dateFormatSymbols.getMonths() [index - 1]; 
38} 

39 

40 public String toShortString() { 

41 return dateFormatSymbols.getShortMonths() [index - 1]; 


42 } 

43 

44 public static Month parse(String s) ( 

45 S = s.trim(); 

46 for (Month m : Month.values()) 

47 . if (m.matches(s)) 

48 return m; 

49 

50 try ( 

51 return fromInt (Integer.parseInt(s)); 
52 } | 

53 catch (NumberFormatException e) () 

54 throw new IllegalArgumentException("Inváàlid month " + s); 
55} 

56 

57 private boolean matches (String s) ( 

58 return s.equalsIgnoreCase(toString()) || 
59 s.equalsIgnoreCase (toShortString()); 
60 } 

61 

62 . public int toInt() { 

63 return index; 

64 } 

65 } 


代码 清单 B-9 Dayjava (最终 版 本 ) 





1 package org.jfree.date; 

2 

3 import java.util.Calendar; 

4 import java.text.DateFormatSymbols; 
5 
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6 public enum Day ( 


7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
21 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 } 


MONDAY (Calendar .MONDAY), 
TUESDAY (Calendar.TUESDAY), 
WEDNESDAY (Calendar.WEDNESDAY), 
THURSDAY (Calendar.THURSDAY), 
FRIDAY (Calendar.FRIDAY), 
SATURDAY (Calendar.SATURDAY), 
SUNDAY (Calendar.SUNDAY); 


private final int index; 
private static DateFormatSymbols dateSymbols = new DateFormatSymbols(); 


Day(int day) ( 
index = day; 


) 


public static Day fromInt(int index) throws IllegalArgumentException { 
for (Day d : Day.values()) 
-if (d.index == index) 
return d; , 
throw new IllegalArgumentException( 
String.format("Illegal day index: $d.", index)); 
) 


public static Day parse(String s) throws IllegalArgumentException { 
String[] shortWeekdayNames - 
dateSymbols.getShortWeekdays(); 
String[] weekDayNames - 
dateSymbols.getWeekdays (); 


S = s.trim(); 
for (Day day : Day.values()) ( 
if (s.equalsIgnoreCase (shortWeekdayNames[day.index]) || 
s.equalsIgnoreCase (weekDayNames[day.index])) { 
return day; | 
) 
| 
throw new IllegalArgumentException( 
String.format("$s is not a valid weekday string", s)); 


) 


public String toString() ( 
return dateSymbols.getWeekdays() [index]; 
) 


public int toInt() ( 
return index; 
) 


代码 清单 B-10 Datelntervaljava (RAME) 


1 package org.jfree.date; 


2 


382 附录 B org.jfree.date.SerialDate 


3 
4 
5 
6 
7 
8 


VO 


public enum DateInterval ( 


) 


OPEN { 
public boolean isIn(int d, int left, int right) ( 
return d » left && d « right; 
} 
), 
CLOSED LEFT { 
public boolean isIn(int d, int left, int right) { 
return d >= left && d « right; | 
} 
be 
CLOSED_RIGHT { 
public boolean isIn(int d, int left, int right) { 
return d > left && d <= right; 
he 
CLOSED { 
public boolean isIn(int d, int left, int right) { 
return d >= left && d <= right; | 
) 
}; 


public abstract boolean isIn(int d, int left, int right); 


代码 清单 B-11 WeekinMonthjava (RAME) 
1 package org.jfree.date; 


NO 


3 
4 
2 
6 
7 
8 





public enum WeekInMonth { 


) 


FIRST(1), SECOND(2), THIRD(3), FOURTH(4), LAST(0); 
private final int index; 


WeekInMonth(int index) { 
this.index = index; 


} 


public int toInt() { 
return index; 


) 


代码 清单 B-12 WeekdayRange.java (RRRS) 


1 package org.jfree.date; 





2 


3 public enum WeekdayRange { 


4 
5 





) 


LAST, NEAREST, NEXT 


代码 清单 B-13 DateUtiljava (RME) 
1 package org.jfree.date; 
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2 
3 import java.text.DateFormatSymbols; 


4 
5 public class DateUtil { 

6 private static DateFormatSymbols dateFormatSymbols = new DateFormatSymbols(); 
7 

8 


public static String[] getMonthNames() ( 
9 return dateFormatSymbols.getMonths(); 
10 } 
11 
12 public static boolean isLeapYear(int year) { 
13 boolean fourth = year % 4 == 0; 
14 boolean hundredth = year % 100 == 0; 


15 boolean fourHundredth = year % 400 == 0; 

16 return fourth && (!hundredth || fourHundredth) ; 
17 } 

18 


19 public static int lastDayOfMonth(Month month, int year) { 
20 .if (month == Month.FEBRUARY && isLeapYear(year)) 


21 return month.lastDay() + 1; 
22 else 

23 return month.lastDay(); 

24 ) 

25 


26 public static int leapYearCount(int year) { 
27 int leap4 = (year - 1896) / 4; 

28 int leap100 = (year - 1800) / 100; 

29 int leap400 = (year - 1600) / 400; 

30 return leap4 - leap100 + leap400; 

31 .| 

32 } 


代码 清单 B-14 DayDateFactoryjava (RHIA) 


1 package org.jfree.date; 

2 

3 public abstract class DayDateFactory ( 

4 private static DayDateFactory factory = new SpreadsheetDateFactory(); 
5 public static void setInstance(DayDateFactory factory) { 

6 DayDateFactory.factory = factory; 

7 } 

8 


9 protected abstract DayDate _makeDate(int ordinal); 

10 protected abstract DayDate makeDate(int day, Month mónth, int year); 
11 protected abstract DayDate _makeDate(int day, int month, int year); 
12 protected abstract DayDate makeDate(java.util.Date date); 

13 protected abstract int _getMinimumYear () ; 

14 protected abstract int _getMaximumYear () ; 


15 

16 public static DayDate makeDate(int ordinal) { 
17 return factory. makeDate (ordinal); 

18 } 

19 


20 public static DayDate makeDate (int day, Month month, int year) { 
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21 return factory. makeDate(day, month, year); 

22 } 

23 

24 public static DayDate makeDate(int day, int month, int year) { | 
25 return factory. makeDate(day, month, year); 

26 } | 

27 : 

28 public static DayDate makeDate(java.util.Date date) { 
.29 return factory. makeDate (date); 

30 ) 

31 

32 public static int getMinimumYear() { 

33 return factory. getMinimumYear(); 

34 } 

35 

36 public static int getMaximumYear() | 

37 return factory. getMaximumYear(); 

38 } 

39 } 


代码 清单 B-15  SpreadsheetDateFactory.java (最 终 版 本 ) 
1 package org.jfree.date; 


import java.util.*; 


3 

4 

5 public class SpreadsheetDateFactory extends DayDateFactory { 
6 public DayDate _makeDate(int ordinal) ( 

7 return new SpreadsheetDate (ordinal); 

8 ] 


9 e 
10 public DayDate makeDate(int day, Month month, int year) { 
11 return new SpreadsheetDate (day, month, year); 
12 } 
13 
14 public DayDate _makeDate(int day, int month, int year) { 
15 return new SpreadsheetDate(day, month, year); 
16 ) 
17 
18 public DayDate makeDate(Date date) { 
19 final GregorianCalendar calendar - new GregorianCalendar(); 
20 calendar.setTime (date); 
21 | return new SpreadsheetDate( 
‘ 22 calendar. get (Calendar.DATE), 
23 Month. fromInt (calendar.get (Calendar.MONTH) + 1), 
24 calendar. get (Calendar. YEAR) ); 
25 } 
26 


27 protected int _getMinimumYear() { 
28 return SpreadsheetDate.MINIMUM_YEAR_SUPPORTED; 
29 } 


31 protected int  getMaximumYear() { 
32 return SpreadsheetDate.MAXIMUM_YEAR_SUPPORTED; 


33 


34 
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) 
) 





代码 清单 B-16 .SpreadsheetDatejava〈 最 终 版 本 ) 


54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
13 
74 
75 
16 
71 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 


90 . 


91 
92 
93 





* JCommon : a free general purpose class library for the Java(tm) platform 
* ; 

* (C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 

i 

* 

*/ 

package org.jfree.date; 

import static org.jfree.date.Month.FEBRUARY; 

import java.util.*; 

/ kk 

* Represents a date using an integer, in a similar fashion to the 

* implementation in Microsoft Excel. The range of dates supported is 

* 1-Jan-1900 to 31-Dec-9999. 

* <p/> 

* Be aware that there is a deliberate bug in Excel that recognises the year 
* 1900 as a leap year when in fact it is not a leap year. You can find more 
* information on the Microsoft website in article Q181370: 

* <p/> 

* http://support.microsoft.com/support/kb/articles/Q181/3/70.asp 

* <p/> 

* Excel uses the convention that 1-Jan-1900 = 1. This class uses the 

* convention 11-Jan-1900 = 2. 

* The result is that the day number in this class will be different to the 
* Excel figure for January and February 1900...but then Excel adds in an extra 
* day (29-Feb-1900 which does not actually exist!) and from that point forward 
* the day numbers will match. 

* 

* @author David Gilbert 

x / | | 

public class SpreadsheetDate extends DayDate { 


public static final int EARLIEST DATE ORDINAL = 2;. // 1/1/1900 
public static final int LATEST DATE ORDINAL = 2958465; // 12/31/9999 
public static final int MINIMUM, YEAR SUPPORTED - 1900; 
public static final int MAXIMUM YEAR SUPPORTED = 9999; 
static final int[] AGGREGATE DAYS TO END OF PRECEDING MONTH - 
(0, 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365}; 
static final int[] LEAP YEAR, AGGREGATE DAYS TO END OF PRECEDING MONTH = 
(0, 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366); 


private int ordinalDay; 
private int day; 
private Month month; 
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94 
95 


96 | 


97 
98 
99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 


private int year; 


public SpreadsheetDate(int day, Month month, int year) { 
if (year < MINIMUM YEAR SUPPORTED || year > MAXIMUM YEAR - SUPPORTED) 
throw new IllegalArgumentException( 
"The 'year' argument must be in range " 十 
MINIMUM YEAR SUPPORTED + " to " + MAXIMUM YEAR. SUPPORTED 95") 3 
if (day < 1 || day > DateUtil.lastDayOfMonth(month, year) ) 
throw new IllegalArgumentException("Invalid 'day' argument."); 


this.year = year; 

this.month = month; 

this.day = day; 

ordinalDay = calcOrdinal(day, month, year); 


) 


public SpreadsheetDate(int day, int month, int year) { 
this(day, Month.fromInt (month), year); 
} 


public SpreadsheetDate(int serial) { 
if (serial < EARLIEST DATE ORDINAL || serial > LATEST DATE ORDINAL) 
throw new IllegalArgumentException( 
"SpreadsheetDate: Serial must be in range 2 to 2958465."); 


ordinalDay - serial; 
calcDayMonthYear(); 
) 


public int getOrdinalDay() { 
return ordinalDay; 


) 


public int getYear() { 
return year; 


} 


public Month getMonth() { 
return month; 


} 


public int getDayOfMonth() { 
return day; 
} 


protected Day getDayOfWeekForOrdinalZero() {return Day. SATURDAY; } 


public boolean equals(Object object) { 
if (!(object instanceof DayDate) ) 
return false; 


DayDate date = (DayDate) object; 
return date.getOrdinalDay() == getOrdinalDay(); 
} 
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148 T 
149 public int hashCode() { 
150 return getOrdinalDay(); 
151 ] 
152 
153  public.int compareTo(Object other) { 
154 return daysSince((DayDate) other); 
155 ] 
156 | 
157 private int calcOrdinal(int day, Month month, int year) { 
158 int leapDaysForYear = DateUtil.leapYearCount(year - 1); 
159 int daysUpToYear = (year - MINIMUM YEAR SUPPORTED) * 365 + leapDaysForYear; 
160 int daysUpToMonth = AGGREGATE DAYS TO END OF PRECEDING MONTH[month. toInt()]; 
161 if (DateUtil.isLeapYear(year) && month.toInt() > FEBRUARY.toInt()) 
162 daysUpToMonth++; 
163 int daysInMonth = day - 1; 
164 return daysUpToYear + daysUpToMonth + daysInMonth + EARLIEST DATE ORDINAL; 
165 } 
166 i 
167 private void calcDayMonthYear() { 
168 int days = ordinalDay - EARLIEST DATE ORDINAL; 
169 int overestimatedYear = MINIMUM YEAR SUPPORTED + days / 365; 
170 int nonleapdays = days - DateUtil.leapYearCount (overestimatedYear); 
171 int underestimatedYear = MINIMUM YEAR SUPPORTED + nonleapdays / 365; 
172 
173 year = huntForYearContaining(ordinalDay, underestimatedYear); 
174 int firstOrdinalOfYear = firstOrdinalOfYear(year); 
175 month - huntForMonthContaining(ordinalDay, firstOrdinalOfYear); 
176 day = ordinalDay - firstOrdinalOfYear - daysBeforeThisMonth (month.toInt()); 
177 } | 
178 
179 private Month huntForMonthContaining(int anOrdinal, int firstOrdinalOfYear) { 
180 int daysIntoThisYear = anOrdinal - firstOrdinalOfYear; 
181 int aMonth = 1; 
182 while (daysBeforeThisMonth(aMonth) « daysIntoThisYear) 


183 aMontht*; 

184 

185 return Month.fromInt(aMonth - 1); 
186 } 

187 


188 private int daysBeforeThisMonth(int aMonth) { 
189 if (DateUtil.isLeapYear(year)) 


190 return LEAP YEAR AGGREGATE DAYS TO END OF PRECEDING MONTH[aMonth] - 1; 
191 else 

192 return AGGREGATE DAYS TO END OF PRECEDING MONTH[aMonth] - 1; 

193 } 

194 


195 private int huntForYearContaining(int anOrdinalDay, int startingYear) { 
196 int aYear = startingYear; 
197 while (firstOrdinalOfYear(aYear) <= anOrdinalDay) 


198 aYeart*; 
199 
200 return aYear - 1; 


.201 4} 
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202 
203 private int firstOrdinalOfYear(int year) ( 
204 return calcOrdinal(1, Month.JANUARY, year); 


205 } 

206 

207 public static DayDate createInstance(Date date) { 

208 . GregorianCalendar calendar = new GregorianCalendar(); 

209 calendar.setTime (date); 

210 return new d cde eh get (Calendar.DATE), 

211 | . Month, fromInt (calendar.get(Calendar.MONTH) + 1), 
212 calendar.get (Calendar.YEAR)); 

213 

214 } 


215 ] 





